Исходный код вики Настройка интеграции с Avanguard
Версия 1.3 от Всезнайка PROSTO:СКУД на 2025/12/04 06:10
Скрыть последних авторов
| author | version | line-number | content |
|---|---|---|---|
 |
1.1 | 1 | |
| 2 | |||
| 3 | |||
| 4 | |||
| 5 | |||
| 6 | |||
| 7 | |||
| 8 | |||
| 9 | = = | ||
| 10 | |||
| |
1.2 | 11 | = 1. Описание системы = |
| |
1.1 | 12 | |
| 13 | Интеграционные возможности продукта «PROSTO:СКУД»: | ||
| 14 | |||
| 15 | Продукт «PROSTO:СКУД» обеспечивает комплексную интеграцию с системами контроля и управления доступом (СКУД), предоставляя широкий спектр функциональных возможностей: | ||
| 16 | |||
| 17 | 1. Настройка взаимодействия с СКУД: | ||
| 18 | |||
| 19 | * подключение к существующим системам СКУД; | ||
| 20 | * конфигурирование параметров интеграции для каждой системы; | ||
| 21 | * задание расписаний обмена данными между системами. | ||
| 22 | |||
| 23 | (% start="2" %) | ||
| 24 | 1. Управление объектами СКУД: | ||
| 25 | |||
| 26 | Система позволяет создавать новые и сопоставлять существующие объекты с текущими параметрами: | ||
| 27 | |||
| 28 | * Контроллеры; | ||
| 29 | * Группы доступа; | ||
| 30 | * Схемы доступа; | ||
| 31 | * Сотрудники (физические лица). | ||
| 32 | |||
| 33 | (% start="3" %) | ||
| 34 | 1. Контроль и учет карт доступа: | ||
| 35 | |||
| 36 | * выдача карт доступа; | ||
| 37 | * продление срока действия карт; | ||
| 38 | * блокировка карт при необходимости. | ||
| 39 | |||
| 40 | (% start="4" %) | ||
| 41 | 1. Гибкое управление правами доступа: | ||
| 42 | |||
| 43 | * установка ограничений для сотрудников в разрезе схем доступа (для точного учета присутствия); | ||
| 44 | * назначение схем и групп доступа для определения прав прохода через контрольные точки СКУД; | ||
| 45 | |||
| 46 | (% start="5" %) | ||
| 47 | 1. Мониторинг и анализ перемещений: | ||
| 48 | |||
| 49 | * просмотр детальных данных о проходах сотрудников через точки доступа СКУД; | ||
| 50 | * формирование отчетов по перемещениям персонала в заданный период. | ||
| 51 | |||
| 52 | Таким образом, «PROSTO:СКУД» создает единую среду управления доступом, обеспечивая синхронизацию данных и контроль всех процессов, связанных с безопасностью и перемещением персонала. | ||
| |
1.2 | 53 | |
| 54 | = 2. НАСТРОЙКА ИНТЕГРАЦИИ с Avanguard = | ||
| 55 | |||
| 56 | == 2.1. Настройка подключения == | ||
| 57 | |||
| 58 | Для добавления вида системы контроля и учета доступа (СКУД) в подсистеме «PROSTO: СКУД» выполните следующие шаги: | ||
| 59 | |||
| 60 | * Откройте форму «Настройки подсистемы PROSTO: СКУД» в интерфейсе подсистемы. | ||
| 61 | * Перейдите на вкладку «Используемые СКУД». | ||
| 62 | * В списке доступных интеграций найдите нужное наименование системы контроля и учета доступа. | ||
| 63 | * Проставьте пометку (флажок/галочку) напротив выбранного наименования интеграции. | ||
| 64 | * Нажмите кнопку «Записать» для сохранения внесенных настроек. | ||
| 65 | |||
| 66 | После выполнения этих действий выбранная система СКУД будет добавлена и доступна для работы в подсистеме «PROSTO: СКУД». | ||
| 67 | |||
| 68 | [[image:1764827035070-446.png||height="401" width="473"]] | ||
| 69 | |||
| 70 | [[image:1764827838315-209.png||height="432" width="652"]] | ||
| 71 | |||
| 72 | Для корректной работы продукта после первого запуска необходимо выполнить следующую настройку: задать настройки по умолчанию, дождитесь завершения процесса - система автоматически заполнит предопределенные данные и применит основные настройки. | ||
| 73 | |||
| 74 | [[image:1764827866094-287.png||height="448" width="660"]] | ||
| 75 | |||
| 76 | Для настройки подключения к серверу СЛК выполните следующие действия: | ||
| 77 | |||
| 78 | 1. Установите флаг «Запуск приложения в защищенном режиме (СЛК)». | ||
| 79 | 1. После установки флага система автоматически заполнит настройки подключения. | ||
| 80 | 1. Проверьте табличную часть интерфейса: если программное обеспечение сервера СЛК размещено на том же сервере, что и Платформа 1С, в ней отобразится список установленных ключей СЛК. | ||
| 81 | 1. В случае появления предложения о перезапуске системы — подтвердите его, нажав «Да» (или аналогичную кнопку подтверждения). | ||
| 82 | |||
| 83 | После выполнения этих шагов подключение к серверу СЛК будет настроено, а система перезапустится в защищенном режиме. | ||
| 84 | |||
| 85 | [[image:1764827890380-117.png||height="433" width="889"]] | ||
| 86 | |||
| 87 | Если сервер с ПО СЛК физически отделен от сервера 1С, выполните следующие действия: | ||
| 88 | |||
| 89 | 1. Откажитесь от автоматического перезапуска системы. При появлении предложения о перезапуске нажмите «Отменить» или «Нет» — в данном сценарии перезапуск на этом этапе не требуется. | ||
| 90 | 1. В интерфейсе настроек: проверьте и при необходимости измените адрес сервера СЛК; уточните порт подключения (по умолчанию — 9099, но может быть изменен); проверьте учетные данные для аутентификации (если требуется); убедитесь, что указаны корректные параметры сетевого взаимодействия. | ||
| 91 | 1. После успешного установления соединения: сохраните настройки; выполните перезапуск платформы 1С через стандартное меню завершения работы; дождитесь полного перезапуска системы. | ||
| 92 | |||
| 93 | После перезапуска в интерфейсе 1С: | ||
| 94 | |||
| 95 | 1. в группе меню «Сервис» появится обработка «Начальная синхронизация Avanguard»; | ||
| 96 | 1. данная обработка предназначена для выполнения первичной интеграции между системой 1С и СКУД Avanguard; | ||
| 97 | 1. через этот инструмент осуществляется первоначальное сопоставление данных и настройка обмена информацией между системами. | ||
| 98 | |||
| 99 | [[image:1764827925030-819.png||height="323" width="1063"]] | ||
| 100 | |||
| 101 | После завершения настройки необходимо перейти к элементам справочника «Системы контроля доступа» по одноименной ссылке раздела «PROSTO:СКУД». В элементах данного справочника настраиваются параметры подключения к системам СКУД— базовые технические настройки для установления связи с оборудованием, а также настройки интеграционного характера - параметры обмена данными между 1С и СКУД. | ||
| 102 | |||
| 103 | [[image:file:///C:/Users/KALUTS~~1/AppData/Local/Temp/msohtmlclip1/01/clip_image001.png]] [[image:1764827942740-729.png||height="213" width="441"]] | ||
| 104 | |||
| 105 | Для корректной интеграции с системой контроля доступа Avanguard выполните настройку на вкладке «Основные настройки». | ||
| 106 | |||
| 107 | 1. В поле «Вид системы контроля доступа» выберите значение Avanguard из выпадающего списка. | ||
| 108 | 1. Укажите наименование системы — введите удобное для идентификации название. | ||
| 109 | 1. Заполните данные подключения: адрес сервера в облачной сети — IP‑адрес или доменное имя сервера, на котором развернуто ПО Avanguard, имя пользователя — учетная запись для аутентификации в системе Avanguard, пароль — пароль от указанной учетной записи. | ||
| 110 | 1. Активируйте интеграцию с сервером: установите флаг «Используется», чтобы включить взаимодействие с выбранной системой СКУД снимите флаг, если требуется временно отключить интеграцию (например, на период отладки или технического обслуживания). | ||
| 111 | |||
| 112 | [[image:1764827966251-204.png||height="452" width="445"]] | ||
| 113 | |||
| 114 | В справочнике «Системы контроля доступа», помимо базовых параметров подключения, предусмотрены расширенные настройки интеграции. Они располагаются на вкладке «Дополнительные настройки» и определяют состав данных, участвующих в обмене между СКУД и 1С, правила обработки информации, специфические параметры взаимодействия систем. | ||
| 115 | |||
| 116 | Для старта конфигурации воспользуйтесь кнопкой «Заполнить по умолчанию». Система автоматически установит типовые значения для всех полей, задаст базовые правила обмена данными, активирует минимально необходимый набор параметров. | ||
| 117 | |||
| 118 | После автозаполнения внесите индивидуальные изменения для строчных полей — укажите требуемые текстовые значения (например, наименования организации по умолчанию), для числовых полей — задайте количественные параметры (интервалы времени, таймауты, идентификаторы), для логических параметров — установите значение «ДА» в полях, которые должны участвовать в обмене данными. | ||
| 119 | |||
| 120 | Изменять состав параметров можно будет при необходимости добавляя дополнительные настройки из общего справочника. | ||
| 121 | |||
| 122 | При настройке интеграции со СКУД Avanguard ключевым параметром является поле «Код субаккаунта», расположенным на вкладке «Дополнительные настройки». Этот код служит уникальным идентификатором, связывающим Организацию в базе 1С с соответствующим разделом учета в системе Avanguard. Поскольку СКУД Avanguard позволяет вести учет по нескольким независимым компаниям, системе 1С необходимо точно знать, к какой организации относить загружаемых сотрудников и события проходов. | ||
| 123 | |||
| 124 | [[image:1764827998915-128.png||height="452" width="454"]] | ||
| 125 | |||
| 126 | Выберите один из трех сценариев настройки, подходящий для вашей структуры: | ||
| 127 | |||
| 128 | 1. Раздельный учет (Несколько организаций – несколько субаккаунтов) | ||
| 129 | |||
| 130 | В базе 1С ведется учет нескольких организаций и для каждой из них в системе Avanguard заведен отдельный субаккаунт. Для успешной синхронизации вам необходимо создать в справочнике «Система контроля доступа» отдельный элемент для каждой организации. | ||
| 131 | |||
| 132 | В каждом элементе укажите свой уникальный «Код субаккаунта», соответствующий настройкам в Avanguard. В дополнительной настройке параметр «Синхронизировать сотрудников всех организаций» установите «Нет». В регистре «Организации для синхронизации (СКУД)» каждой организации укажите свою «Систему контроля доступа». | ||
| 133 | |||
| 134 | (% start="2" %) | ||
| 135 | 1. Общий режим (Одна или несколько организаций – Один субаккаунт) | ||
| 136 | |||
| 137 | Создайте один элемент в справочнике «Система контроля доступа». Укажите общий «Код субаккаунта». В дополнительных настройках установите параметр «Синхронизировать сотрудников всех организаций» в значение «Да». В результате система будет обмениваться данными по всем сотрудникам базы, игнорируя принадлежность к конкретной организации. | ||
| 138 | |||
| 139 | (% start="3" %) | ||
| 140 | 1. Выборочная синхронизация (Один субаккаунт СКУД – в 1С несколько организаций, но не все должны попадать в СКУД) | ||
| 141 | |||
| 142 | Создайте один элемент в справочнике «Система контроля доступа». Укажите «Код субаккаунта» соответствующий ID в Avanguard. В дополнительной настройке «Синхронизировать сотрудников всех организаций» укажите значение «Нет». Заполните регистр «Организация для синхронизации (СКУД)»: добавьте туда только те организации, сотрудников которых нужно выгружать. В результате сотрудники лишних организаций будут проигнорированы системой. | ||
| 143 | |||
| 144 | [[image:1764828100443-673.png||height="205" width="632"]] | ||
| 145 | |||
| 146 | [[image:1764828110249-764.png||height="360" width="491"]] | ||
| 147 | |||
| 148 | [[image:1764828122316-647.png||height="165" width="592"]] | ||
| 149 | |||
| 150 | *При использовании защищенного соединения требуется в поле соответствующей дополнительной настройки установить значение «Да». | ||
| 151 | |||
| 152 | [[image:1764828140815-690.png||height="287" width="440"]] | ||
| 153 | |||
| 154 | Полный состав предопределенных настроек, применимых к различным СКУД, можно посмотреть по ссылке «Дополнительные настройки СКУД» раздела «PROSTO: СКУД». Подробное описание каждой из дополнительных настроек вы найдете в соответствующем доп. приложении. | ||
| 155 | |||
| 156 | [[image:1764828158757-810.png||height="319" width="714"]] | ||
| 157 | |||
| 158 | После того как все необходимые поля будут заполнены, следует проверить подключение к серверу СКУД. Для этого перейдите на вкладку «Основные настройки» и нажмите кнопку «Проверить соединение». | ||
| 159 | |||
| 160 | Если конфигурация выполнена корректно, на форме отобразятся уведомления об успешном подключении к системе СКУД. | ||
| 161 | |||
| 162 | [[image:1764828158759-495.png||height="366" width="361"]] | ||
| 163 | |||
| |
1.3 | 164 | == 2.2. Начальная синхронизация с Avanguard == |
| |
1.2 | 165 | |
| |
1.3 | 166 | Существует два основных подхода к началу работы с системой PROSTO:СКУД: |
| |
1.2 | 167 | |
| |
1.3 | 168 | 1. Предварительное создание справочных данных |
| 169 | |||
| 170 | * В системе PROSTO:СКУД последовательно создаются все необходимые справочные данные. | ||
| 171 | * После завершения настройки данные автоматически выгружаются в СКУД посредством регламентного задания (подробнее в п.п. 2.3). | ||
| 172 | |||
| 173 | (% start="2" %) | ||
| 174 | 1. Работа с уже действующей СКУД | ||
| 175 | |||
| 176 | * Подход применяется, если СКУД уже функционирует на момент внедрения PROSTO:СКУД и содержит актуальные данные. | ||
| 177 | * Для синхронизации данных в PROSTO:СКУД предусмотрены специальные обработки «Начальная синхронизация». | ||
| 178 | * Каждая обработка адаптирована под конкретный тип СКУД, что обеспечивает корректное сопоставление и перенос данных. | ||
| 179 | |||
| 180 | |||
| 181 | |||
| 182 | [[image:file:///C:/Users/KALUTS~~1/AppData/Local/Temp/msohtmlclip1/01/clip_image001.png]][[image:1764828477111-901.png||height="334" width="1005"]] | ||
| 183 | |||
| 184 | |||
| 185 | Для вызова обработки начальной синхронизации с СКУД Avanguard необходимо перейти в раздел «PROSTO: СКУД» – Сервис – Начальная синхронизация Avanguard. | ||
| 186 | |||
| 187 | Открыв обработку, необходимо выбрать Систему контроля доступа и перемещаясь между вкладками в том порядке, в котором они расположены в форме обработки, поочередно синхронизировать объекты системы PROSTO: СКУД и Avanguard. | ||
| 188 | |||
| 189 | Для того, чтобы данные отобразились в строках табличной части, необходимо нажать кнопку «Заполнить». | ||
| 190 | |||
| 191 | [[image:file:///C:/Users/KALUTS~~1/AppData/Local/Temp/msohtmlclip1/01/clip_image002.png]][[image:1764828495027-884.png||height="347" width="901"]] | ||
| 192 | |||
| 193 | Каждая запись об объекте в табличной части структурирована особым образом — она разделена на две строки для наглядного сравнения: | ||
| 194 | |||
| 195 | * Первая строка содержит данные из основной базы «1С». | ||
| 196 | |||
| 197 | * Вторая строка отображает сведения, полученные из системы СКУД Avanguard. | ||
| 198 | |||
| 199 | Первичное сопоставление объектов выполняется по наименованию — система автоматически ищет соответствия между записями двух источников. | ||
| 200 | |||
| 201 | Если данные в базах не совпадают, пользователь получает следующие возможности: | ||
| 202 | |||
| 203 | * вручную сопоставить записи, установив связь между объектами из разных систем; | ||
| 204 | * создать недостающие объекты с помощью встроенных инструментов обработки. | ||
| 205 | |||
| 206 | О наличии несоответствий сигнализирует третья колонка табличной части: | ||
| 207 | |||
| 208 | * если данные не удалось сопоставить, в соответствующей ячейке будет отображено пустое значение. | ||
| 209 | |||
| 210 | [[image:file:///C:/Users/KALUTS~~1/AppData/Local/Temp/msohtmlclip1/01/clip_image003.png]][[image:1764828518789-605.png||height="285" width="890"]] | ||
| 211 | |||
| 212 | Для обеспечения полного соответствия данных между системой 1С и СКУД необходимо выполнить их синхронизацию. | ||
| 213 | |||
| 214 | Для этого необходимо выбрать приоритет синхронизации: СКУД (загрузка данных из СКУД в 1С) или 1С (выгрузка данных из 1С в СКУД), отметить флажками нужные строки и нажать кнопку «Синхронизировать». | ||
| 215 | |||
| 216 | Если синхронизация данных прошла успешно, в первой колонке появится надпись Данные синхронизированы. | ||
| 217 | |||
| 218 | [[image:1764828548215-726.png||height="219" width="893"]] [[image:file:///C:/Users/KALUTS~~1/AppData/Local/Temp/msohtmlclip1/01/clip_image004.png]] | ||
| 219 | |||
| 220 | При этом система создаст запись идентификатора объекта в системе СКУД в регистр сведений «Идентификаторы объектов СКУД». | ||
| 221 | |||
| 222 | [[image:1764828562770-175.png||height="400" width="432"]] | ||
| 223 | |||
| 224 | |||
| 225 | [[image:1764828579707-478.png||height="161" width="883"]] | ||
| 226 | |||
| 227 | То, как поведет себя система при сопоставлении объектов, будет ли объект перезаписан или просто сопоставлен при помощи идентификатора, задается в дополнительных настройках элемента справочника «Системы контроля доступа» | ||
| 228 | |||
| 229 | [[image:1764828596829-855.png||height="357" width="384"]] | ||
| 230 | |||
| 231 | Отдельно рассмотрим каждую вкладку обработки интеграции: | ||
| 232 | |||
| 233 | |||
| |
1.2 | 234 |