Настройка интеграции с Avanguard

Версия 1.3 от Всезнайка PROSTO:СКУД на 2025/12/04 06:10

 

1. Описание системы

Интеграционные возможности продукта «PROSTO:СКУД»:

Продукт «PROSTO:СКУД» обеспечивает комплексную интеграцию с системами контроля и управления доступом (СКУД), предоставляя широкий спектр функциональных возможностей:

  1. Настройка взаимодействия с СКУД:
  • подключение к существующим системам СКУД;
  • конфигурирование параметров интеграции для каждой системы;
  • задание расписаний обмена данными между системами.
  1. Управление объектами СКУД:

Система позволяет создавать новые и сопоставлять существующие объекты с текущими параметрами:

  • Контроллеры;
  • Группы доступа;
  • Схемы доступа;
  • Сотрудники (физические лица).
  1. Контроль и учет карт доступа:
  • выдача карт доступа;
  • продление срока действия карт;
  • блокировка карт при необходимости.
  1. Гибкое управление правами доступа:
  • установка ограничений для сотрудников в разрезе схем доступа (для точного учета присутствия);
  • назначение схем и групп доступа для определения прав прохода через контрольные точки СКУД;
  1. Мониторинг и анализ перемещений:
  • просмотр детальных данных о проходах сотрудников через точки доступа СКУД;
  • формирование отчетов по перемещениям персонала в заданный период.

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

2. НАСТРОЙКА ИНТЕГРАЦИИ с Avanguard

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

Для добавления вида системы контроля и учета доступа (СКУД) в подсистеме «PROSTO: СКУД» выполните следующие шаги:

  • Откройте форму «Настройки подсистемы PROSTO: СКУД» в интерфейсе подсистемы.
  • Перейдите на вкладку «Используемые СКУД».
  • В списке доступных интеграций найдите нужное наименование системы контроля и учета доступа.
  • Проставьте пометку (флажок/галочку) напротив выбранного наименования интеграции.
  • Нажмите кнопку «Записать» для сохранения внесенных настроек.

После выполнения этих действий выбранная система СКУД будет добавлена и доступна для работы в подсистеме «PROSTO: СКУД».

1764827035070-446.png

1764827838315-209.png ​​​​​​​

Для корректной работы продукта после первого запуска необходимо выполнить следующую настройку: задать настройки по умолчанию, дождитесь завершения процесса - система автоматически заполнит предопределенные данные и применит основные настройки.

1764827866094-287.png ​​​​​​​

Для настройки подключения к серверу СЛК выполните следующие действия:

  1. Установите флаг «Запуск приложения в защищенном режиме (СЛК)».
  2. После установки флага система автоматически заполнит настройки подключения.
  3. Проверьте табличную часть интерфейса: если программное обеспечение сервера СЛК размещено на том же сервере, что и Платформа 1С, в ней отобразится список установленных ключей СЛК.
  4. В случае появления предложения о перезапуске системы — подтвердите его, нажав «Да» (или аналогичную кнопку подтверждения).

После выполнения этих шагов подключение к серверу СЛК будет настроено, а система перезапустится в защищенном режиме.

1764827890380-117.png ​​​​​​​

Если сервер с ПО СЛК физически отделен от сервера 1С, выполните следующие действия:

  1. Откажитесь от автоматического перезапуска системы. При появлении предложения о перезапуске нажмите «Отменить» или «Нет» — в данном сценарии перезапуск на этом этапе не требуется.
  2. В интерфейсе настроек: проверьте и при необходимости измените адрес сервера СЛК; уточните порт подключения (по умолчанию — 9099, но может быть изменен); проверьте учетные данные для аутентификации (если требуется); убедитесь, что указаны корректные параметры сетевого взаимодействия.
  3. После успешного установления соединения: сохраните настройки; выполните перезапуск платформы 1С через стандартное меню завершения работы; дождитесь полного перезапуска системы.

После перезапуска в интерфейсе 1С:

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

1764827925030-819.png ​​​​​​​

После завершения настройки необходимо перейти к элементам справочника «Системы контроля доступа» по одноименной ссылке раздела «PROSTO:СКУД». В элементах данного справочника настраиваются параметры подключения к системам СКУД— базовые технические настройки для установления связи с оборудованием, а также настройки интеграционного характера - параметры обмена данными между 1С и СКУД.

file:///C:/Users/KALUTS~1/AppData/Local/Temp/msohtmlclip1/01/clip_image001.png 1764827942740-729.png ​​​​​​​

Для корректной интеграции с системой контроля доступа Avanguard выполните настройку на вкладке «Основные настройки».

  1. В поле «Вид системы контроля доступа» выберите значение Avanguard из выпадающего списка.
  2. Укажите наименование системы — введите удобное для идентификации название.
  3. Заполните данные подключения: адрес сервера в облачной сети — IP‑адрес или доменное имя сервера, на котором развернуто ПО Avanguard, имя пользователя — учетная запись для аутентификации в системе Avanguard, пароль — пароль от указанной учетной записи.
  4. Активируйте интеграцию с сервером: установите флаг «Используется», чтобы включить взаимодействие с выбранной системой СКУД снимите флаг, если требуется временно отключить интеграцию (например, на период отладки или технического обслуживания).

1764827966251-204.png ​​​​​​​

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

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

После автозаполнения внесите индивидуальные изменения для строчных полей — укажите требуемые текстовые значения (например, наименования организации по умолчанию), для числовых полей — задайте количественные параметры (интервалы времени, таймауты, идентификаторы), для логических параметров — установите значение «ДА» в полях, которые должны участвовать в обмене данными.

Изменять состав параметров можно будет при необходимости добавляя дополнительные настройки из общего справочника.

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

1764827998915-128.png ​​​​​​​

Выберите один из трех сценариев настройки, подходящий для вашей структуры:

  1. Раздельный учет (Несколько организаций – несколько субаккаунтов)

В базе 1С ведется учет нескольких организаций и для каждой из них в системе Avanguard заведен отдельный субаккаунт. Для успешной синхронизации вам необходимо создать в справочнике «Система контроля доступа» отдельный элемент для каждой организации.

В каждом элементе укажите свой уникальный «Код субаккаунта», соответствующий настройкам в Avanguard. В дополнительной настройке параметр «Синхронизировать сотрудников всех организаций» установите «Нет». В регистре «Организации для синхронизации (СКУД)» каждой организации укажите свою «Систему контроля доступа».

  1. Общий режим (Одна или несколько организаций – Один субаккаунт)

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

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

Создайте один элемент в справочнике «Система контроля доступа».  Укажите «Код субаккаунта» соответствующий ID в Avanguard. В дополнительной настройке «Синхронизировать сотрудников всех организаций» укажите значение «Нет». Заполните регистр «Организация для синхронизации (СКУД)»: добавьте туда только те организации, сотрудников которых нужно выгружать. В результате сотрудники лишних организаций будут проигнорированы системой.

1764828100443-673.png ​​​​​​​

1764828110249-764.png ​​​​​​​

1764828122316-647.png ​​​​​​​

*При использовании защищенного соединения требуется в поле соответствующей дополнительной настройки установить значение «Да».

1764828140815-690.png

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

1764828158757-810.png

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

Если конфигурация выполнена корректно, на форме отобразятся уведомления об успешном подключении к системе СКУД.

1764828158759-495.png ​​​​​​​

2.2. Начальная синхронизация с Avanguard

Существует два основных подхода к началу работы с системой PROSTO:СКУД:

  1. Предварительное создание справочных данных
  • В системе PROSTO:СКУД последовательно создаются все необходимые справочные данные.
  • После завершения настройки данные автоматически выгружаются в СКУД посредством регламентного задания (подробнее в п.п. 2.3).
  1. Работа с уже действующей СКУД
  • Подход применяется, если СКУД уже функционирует на момент внедрения PROSTO:СКУД и содержит актуальные данные.
  • Для синхронизации данных в PROSTO:СКУД предусмотрены специальные обработки «Начальная синхронизация».
  • Каждая обработка адаптирована под конкретный тип СКУД, что обеспечивает корректное сопоставление и перенос данных.

file:///C:/Users/KALUTS~1/AppData/Local/Temp/msohtmlclip1/01/clip_image001.png1764828477111-901.png ​​​​​​​

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

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

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

file:///C:/Users/KALUTS~1/AppData/Local/Temp/msohtmlclip1/01/clip_image002.png1764828495027-884.png ​​​​​​​

Каждая запись об объекте в табличной части структурирована особым образом — она разделена на две строки для наглядного сравнения:

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

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

Если данные в базах не совпадают, пользователь получает следующие возможности:

  • вручную сопоставить записи, установив связь между объектами из разных систем;
  • создать недостающие объекты с помощью встроенных инструментов обработки.

О наличии несоответствий сигнализирует третья колонка табличной части:

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

file:///C:/Users/KALUTS~1/AppData/Local/Temp/msohtmlclip1/01/clip_image003.png1764828518789-605.png ​​​​​​​

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

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

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

 1764828548215-726.png ​​​​​​​file:///C:/Users/KALUTS~1/AppData/Local/Temp/msohtmlclip1/01/clip_image004.png

При этом система создаст запись идентификатора объекта в системе СКУД в регистр сведений «Идентификаторы объектов СКУД».

1764828562770-175.png ​​​​​​​ ​​​​​​​

1764828579707-478.png ​​​​​​​

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

1764828596829-855.png ​​​​​​​

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