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

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

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

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

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

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

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

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

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

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

* **Основные параметры:**
* `логин и пароль оператора` RusGuard, от лица которого будет работать PassOffice. Для обновления пароля:
  * Установите галочку **«Обновить пароль»**
  * Введите **новый пароль** в соответствующее поле и после этого нажмите **«Сохранить»**.
* `URL СКД:` сервиса интеграции RusGuard, например, `https://localhost/LNetworkServer/LNetworkService.svc?wsdl`
* `Connection timeout и Read timeout`: задайте значения тайм-аутов для соединения и чтения данных.

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

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

* *Слот для фото:* выберите 1, 2 или 3, в выбранном слоте фото будет отгружено в RusGuard
* *Разрешать слияние конфликтов при импорте -* при включенной настройке при импорте людей из интеграций объединяются похожие посетители.

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

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

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

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

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

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

**Пропуска:**

* *Тип пропуска:* выберите тип карты - Постоянный, Посетитель, Временный, Транспортный, с которым будет работа в СКД RusGuard
* Выберите стратегию выдачи временного пропуска на основе постоянного или бессрочного:

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

**События:**

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

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

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

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

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

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

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

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

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

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

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

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

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