# Конфигурирование интеграции с СКД 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.aamsystems.ru/passoffice/passoffice-guide/admin-guide-doc/acs-configuration/konfigurirovanie-s-skd-rusguard.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.