> For the complete documentation index, see [llms.txt](https://docs.aamsystems.ru/passoffice/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aamsystems.ru/passoffice/passoffice-guide/admin-guide-doc/acs-configuration/acs-sigur.md).

# Конфигурирование интеграции с СКД Sigur

**Настройка интеграции PassOffice с Sigur: Пошаговая инструкция**

Данное руководство описывает процесс настройки интеграции между PassOffice и системой контроля доступа Sigur. Выполните следующие шаги под учетной записью администратора PassOffice.

**Предварительные требования:**

**1.** Установите и запустите СКД Sigur согласно инструкции.

**2**.Cоздайте отдельного оператора в Sigur, у которого есть права на REST API.

**Настройка PassOffice:**

**1. Запуск сервера PassOffice:** Запустите сервер PassOffice, используя файл `PassOfficeSrv.bat`.

**2. Авторизация в PassOffice:** Откройте браузер, введите адрес сервера PassOffice (например, `localhost:80`) и авторизуйтесь под учетной записью администратора.

**3**. **Переход к настройкам интеграции:** Откройте пункт меню «Администрирование / Настройки интеграции».

**4. Редактирование настроек Sigur:**

* **Основные параметры:**
* `Ключ и Пароль интеграции` (логин и пароль от созданного оператора). Для обновления пароля:
  * Установите галочку **«Обновить пароль»**
  * Введите **новый пароль** в соответствующее поле и после этого нажмите **«Сохранить»**.
* `URL СКД,` например, `http://localhost:9500`
* `Connection timeout и Read timeout`: задайте значения тайм-аутов для соединения и чтения данных.

• **Вкладка «Дополнительные настройки»:**

**Синхронизация:**

* *Маска для ФИО:* задайте маску*,* например {surname} {name} {middleName}
* *Разрешать слияние конфликтов при импорте -* при включенной настройке при импорте людей из интеграций объединяются похожие посетители.

**Режимы отгрузки**

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

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

**Режимы удаления**

* *Удалять в СКУД при удалении в бюро пропусков -* при удалении посетителя или пропуска в PassOffice будет удалена соответствующая запись в ПК Sigur.
* *Деактивировать в СКУД при удалении в бюро пропусков -* при удалении посетителя или пропуска в PassOffice, пропуск в ПК Sigur деактивируется, посетитель становится неактивным.
* *Не отрабатывать удаление -* при удалении посетителя в PassOffice, посетитель в ПК Sigur остается активным.

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

• **Тест соединения:** обязательно проведите тест соединения после ввода параметров.

* **Успешный тест:** активируйте настройки соединения с СКД.
* **Ошибка:** проверьте логи СКД Sigur и сервера PassOffice для выявления и устранения проблемы.

• **Соответствие категорий:** укажите соответствие между категориями пользователей в PassOffice и СКД: сотрудники, посетители, автомобили и VIP-Посетители. Это необходимо для корректной передачи информации о типе пользователя в СКД.

> Например, сотрудники могут быть отгружены в соответствующий контейнер Сотрудники.

{% hint style="info" %}
*Для конфигурирования категорий в СКД Sigur в разделе «Персонал» создайте контейнеры для каждой категории: Персонал, Сотрудники, VIP-посетители и далее укажите их в настройках интеграции СКД Sigur.*
{% endhint %}

• **Настройка полей:**

Сконфигурируйте поля человека и пропуска, указав какие поля необходимо отгружать или импортировать из СКД, а также стратегию слияния при импорте:

* *Сторонняя система, очищать -* если поле есть и в PassOffice и в СКУД, то оно будет заменено на соответствующее из СКУД. Если поле есть в PassOffice, но нет в СКУД, то поле в PassOffice будет очищено. Если каких-то полей нет в PassOffice, но есть в СКУД, то оно заменится на соответствующее из СКУД.
* *Сторонняя система, дополнять -* если поле есть и в PassOffice и в СКУД, то оно будет заменено на соответствующее из СКУД. Если поле есть в PassOffice, но нет в СКУД, то поле отгрузится из PassOffice. Если каких-то полей нет в PassOffice, но есть в СКУД, то оно заменится на соответствующее из СКУД.
* *Бюро пропусков -* при расхождении данных, поля из PassOffice останутся приоритетными. Если каких-то полей нет в PassOffice, но есть в СКУД, то оно заменится на соответствующее из СКУД. И если есть поля в PassOffice, но нет в СКУД - недостающие поля отгружаются в СКУД.

**Поля посетителя, которые синхронизируются с СКД Sigur:**

|    Поля   | Отгрузка в СКД | Импорт из СКД |
| :-------: | :------------: | :-----------: |
|    ФИО    |        +       |       +       |
|    Фото   |        +       |       +       |
| Категория |        +       |       +       |

**Поля пропуска, которые синхронизируются с СКД Sigur:**

|       Поля      | Отгрузка в СКД | Импорт из СКД |
| :-------------: | :------------: | :-----------: |
|  Номер пропуска |        +       |       +       |
| Код организации |        +       |       +       |

• **Реактивация/Деактивация соединения:** используйте соответствующие кнопки для управления состоянием соединения с СКД.

После выполнения этих шагов интеграция PassOffice с Sigur должна быть настроена. Рекомендуется проверить работоспособность интеграции путем создания тестовой заявки и отслеживания её в системе Sigur.

{% hint style="info" %}
*Группы доступа указываются в посетителе во вкладке «Доступ», то есть отгружаются в человека, а не в пропуск. При создании заявки обязательно указание группы доступа первого уровня.*
{% endhint %}

{% hint style="info" %}
*Для посетителей при перевыдаче пропуска группы доступа заменяются, для сотрудников - объединяются.*
{% endhint %}

{% hint style="info" %}
*Если у Сотрудника в СКД Sigur в пропуске не указаны даты активации и деактивации пропуска, то после импорта в PassOffice он будет отображаться как бессрочный. Если в PassOffice создан бессрочный пропуск, то в СКД Sigur он также будет отображаться как бессрочный.*
{% endhint %}