> 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-bolid.md). # Конфигурирование интеграции с СКД Bolid **Настройка интеграции PassOffice с Bolid: Пошаговая инструкция** Данное руководство описывает процесс настройки интеграции между PassOffice и системой контроля доступа Bolid. Выполните следующие шаги под учетной записью администратора PassOffice. **Предварительные требования:** **1.** Установите и запустите СКД Орион согласно инструкции. **2.** Запустите модуль интеграции Орион (согласно инструкции к CКД). **Настройка PassOffice:** **1. Запуск сервера PassOffice:** Запустите сервер PassOffice, используя файл `PassOfficeSrv.bat`. **2. Авторизация в PassOffice:** Откройте браузер, введите адрес сервера PassOffice (например, `localhost:80`) и авторизуйтесь под учетной записью администратора. **3**. **Переход к настройкам интеграции:** Откройте пункт меню «Администрирование / Настройки интеграции». **4. Редактирование настроек Bolid:** * **Основные параметры:** * `Логин и пароль оператора Bolid`: укажите логин и пароль оператора Bolid, от лица которого будет работать PassOffice. Для обновления пароля: * Установите галочку **«Обновить пароль»** * Введите **новый пароль** в соответствующее поле и после этого нажмите **«Сохранить»**. * `URL СКД,` например, `http://localhost:8080/` * `Connection timeout и Read timeout`: задайте значения тайм-аутов для соединения и чтения данных. * *Использовать аутентификацию:* укажите URL модуля интеграции Орион. • **Вкладка «Дополнительные настройки»:** **Синхронизация:** * *Разрешать слияние конфликтов при импорте -* при включенной настройке при импорте людей из интеграций объединяются похожие посетители. * *Интегрировать автомобиль как человека* - при включенной настройке автомбиль отгружается в СКУД как посетитель. **Режимы отгрузки** * *Отгружать только через заявку -* данные о пользователе и его пропуске передаются в систему СКУД после обработки заявки. * *Не отгружать* - информация о пользователе и пропуске полностью блокируется для автоматической передачи в систему СКУД при любых действиях в системе - создании заявки, редактировании данных пользователя или пропуска. * *Всегда отгружать* - данные синхронизируются с системой СКУД при любом изменении, независимо от наличия заявки. Эти режимы могут быть назначены как глобально для всей системы, так и индивидуально для отдельных категорий пользователей. **Режимы удаления** * *Удалять в СКУД при удалении в бюро пропусков -* при удалении посетителя или пропуска в PassOffice будет удалена соответствующая запись в ПК Bolid. * *Деактивировать в СКУД при удалении в бюро пропусков -* при удалении посетителя или пропуска в PassOffice, посетитель в ПК Bolid остается со статусом «неактивен», пропуск при этом деактивируется. * *Не отрабатывать удаление -* при удалении посетителя в PassOffice, посетитель в ПК Bolid остается активным. Эти режимы могут быть назначены как глобально для всей системы, так и индивидуально для отдельных категорий пользователей. **Пропуска** Выберите стратегию выдачи временного пропуска на основе постоянного: | **Стратегия** | **Действие** | **Когда использовать** | | -------------------------------------- | ----------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | | **Сдвигать даты постоянного пропуска** | Период действия постоянного пропуска автоматически продлевается на срок временного. | Если нужно сохранить постоянный пропуск, но временно изменить срок его действия. | | **Деактивировать постоянный пропуск** | Постоянный пропуск отключается на время действия временного. | Если временный пропуск должен полностью заменить постоянный (например, для гостевого доступа). | * *«Срок действия бессрочного пропуска» -* укажите срок действия, который будет назначен бессрочному пропуску из PassOffice при отгрузке в СКД Bolid. Если в PassOffice создан бессрочный пропуск, то в СКД Bolid пропуск будет отгружен со сроком действия, указанным в «Настройках интеграции». **События:** * *Импортировать события доступа начиная с:* определите период времени для синхронизации событий между PassOffice и СКД. Этот параметр определяет, как часто PassOffice будет получать обновления из СКД. * *Конфигурация размера пакетов для импорта:* оптимизируйте процесс импорта данных из СКД, указав размер пакетов для различных типов объектов: человек, группа доступа, сообщение из СКД, считыватель. • **Тест соединения:** обязательно проведите тест соединения после ввода параметров. * **Успешный тест:** активируйте настройки соединения с СКД. * **Ошибка:** проверьте логи СКД Bolid и сервера PassOffice для выявления и устранения проблемы. • **Соответствие категорий:** укажите соответствие между категориями пользователей в PassOffice и СКД: сотрудники и посетители. Это необходимо для корректной передачи информации о типе пользователя в СКД.
Категории в PassOfficeОтгрузка в СКД Bolid из PassOfficeИмпорт из СКД Bolid в PassOffice
ПосетительПосетительПосетитель
VIP-ПосетительПосетитель−
СотрудникСотрудник (со статусом Хозорган)Cотрудник ( со статусом Хозорган)
• **Настройка полей:** Сконфигурируйте поля человека и пропуска, указав какие поля необходимо отгружать или импортировать из СКД, а также стратегию слияния при импорте: * *Сторонняя система, очищать -* если поле есть и в PassOffice и в СКУД, то оно будет заменено на соответствующее из СКУД. Если поле есть в PassOffice, но нет в СКУД, то поле в PassOffice будет очищено. Если каких-то полей нет в PassOffice, но есть в СКУД, то оно заменится на соответствующее из СКУД. * *Сторонняя система, дополнять -* если поле есть и в PassOffice и в СКУД, то оно будет заменено на соответствующее из СКУД. Если поле есть в PassOffice, но нет в СКУД, то поле отгрузится из PassOffice. Если каких-то полей нет в PassOffice, но есть в СКУД, то оно заменится на соответствующее из СКУД. * *Бюро пропусков -* при расхождении данных, поля из PassOffice останутся приоритетными. Если каких-то полей нет в PassOffice, но есть в СКУД, то оно заменится на соответствующее из СКУД. И если есть поля в PassOffice, но нет в СКУД - недостающие поля отгружаются в СКУД. **Поля посетителя, которые синхронизируются с СКД Bolid:** | Поля | Отгрузка в СКД | Импорт из СКД | | :-----------: | :------------: | :-----------: | | ФИО | + | + | | Фото | + | + | | Категория | + | + | | Дата рождения | + | + | | Email | + | + | | Пол | + | + | **Поля пропуска, которые синхронизируются с СКД Bolid:** | Поля | Отгрузка в СКД | Импорт из СКД | | :-------------: | :------------: | :-----------: | | Номер пропуска | + | + | | Код организации | + | + | • **Реактивация/Деактивация соединения:** используйте соответствующие кнопки для управления состоянием соединения с СКД. После выполнения этих шагов интеграция PassOffice с Bolid должна быть настроена. Рекомендуется проверить работоспособность интеграции путем создания тестовой заявки и отслеживания её в системе Bolid.