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

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

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

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

**1.** Настройте интеграцию по инструкции к СКД Parsec.

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

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

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

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

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

• **Вкладка «Основные»:**

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

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

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

* *Разрешать слияние конфликтов при импорте -* при включенной настройке при импорте людей из интеграций объединяются похожие посетители.
* *Использовать черный список Parsec -* включите опцию, чтобы при импорте данных из Parsec, если человек находится в черном списке Parsec, в PassOffice он также будет отмечен как заблокированный.

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

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

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

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

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

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

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

* *Использовать генератор QR Parsec:* шифрование номера пропуска через API Parsec для генерации QR-кода.
* *Количество бит у кода организации и количество бит у номера пропуска -* укажите количество бит для настройки разрядности. Например, код организации: `8 бит`Номер пропуска: `16 бит`
* Выберите стратегию выдачи временного пропуска на основе постоянного или бессрочного постоянного:

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

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

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

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

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

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

> Например, сотрудники могут быть отгружены в соответствующее подразделение Сотрудники. Если подразделение не указано, то отгрузка будет в SYSTEM (корень).
>
> При импорте пользователей, если в настройках указано соответсвие категорий, посетителю из выбранного подразделения проставляется соответствующая категория. Если подразделение не указано в соответствие категорий, то будет присвоена родительская категория.

Для проставления подразделения, например, автомобилю при отгрузке воспользуйтесь следующим правилом для людей как на рисунке:

<figure><img src="/files/dirgb5c233bVXnGiKVdJ" alt=""><figcaption><p>Пример правила для категории - Автомобиль</p></figcaption></figure>

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

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

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

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

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

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

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

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

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

{% hint style="info" %}
Посетителям может быть выдан только один пропуск, а Сотрудникам несколько.
{% endhint %}

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

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

{% hint style="info" %}
При блокировке пропуска в СКД Parsec будут проставлены чек-боксы "Вход запрещен" и "Выход запрещен".
{% endhint %}

{% hint style="info" %}
При импорте считывателя *Дверь*, создается 2 объекта - "Вход" и "Выход".
{% endhint %}


---

# 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/acs-parsec.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.