# Конфигурирование интеграции с СКД PERCo **Настройка интеграции PassOffice с PERCo: Пошаговая инструкция** Данное руководство описывает процесс настройки интеграции между PassOffice и системой контроля доступа PERCo. Выполните следующие шаги под учетной записью администратора PassOffice. **Предварительные требования:** **1.** Настройте интеграцию по инструкции к СКД PERCo. **Настройка PassOffice:** **1. Запуск сервера PassOffice:** Запустите сервер PassOffice, используя файл `PassOfficeSrv.bat`. **2. Авторизация в PassOffice:** Откройте браузер, введите адрес сервера PassOffice (например, `localhost:80`) и авторизуйтесь под учетной записью администратора. **3**. **Переход к настройкам интеграции:** Откройте пункт меню «Администрирование / Настройки интеграции». **4. Редактирование настроек PERCo:** • **Вкладка «Основные»:** * `Логин и пароль оператора PERCo` : укажите логин и пароль оператора `PERCo`, от лица которого будет работать PassOffice. Для обновления пароля: * Установите галочку **«Обновить пароль»** * Введите **новый пароль** в соответствующее поле и после этого нажмите **«Сохранить»**. * `URL СКД:`сервиса интеграции PERCo, например, `http://192.168.2.110/api` * `Connection timeout и Read timeout`: задайте значения тайм-аутов для соединения и чтения данных. • **Вкладка «Дополнительные настройки»:** **Синхронизация** * *Отгружать посетителей без пропусков* - при включенной настройке посетитель может быть отгружен без выдачи пропуска после согласования заявки. * *Разрешать слияние конфликтов при импорте -* при включенной настройке при импорте людей из интеграций объединяются похожие посетители. **Режимы отгрузки** * *Отгружать только через заявку -* данные о пользователе и его пропуске передаются в систему СКУД после обработки заявки. * *Не отгружать* - информация о пользователе и пропуске полностью блокируется для автоматической передачи в систему СКУД при любых действиях в системе - создании заявки, редактировании данных пользователя или пропуска. * *Всегда отгружать* - данные синхронизируются с системой СКУД при любом изменении, независимо от наличия заявки. Эти режимы могут быть назначены как глобально для всей системы, так и индивидуально для отдельных категорий пользователей. **Режимы удаления** * *Удалять в СКУД при удалении в бюро пропусков -* при удалении посетителя или пропуска в PassOffice будет удалена соответствующая запись в ПК PERCo. * *Деактивировать в СКУД при удалении в бюро пропусков -* при удалении посетителя в PassOffice, посетитель в ПК PERCo остается со статусом «неактивен». * *Не отрабатывать удаление -* при удалении посетителя в PassOffice, посетитель в ПК APACS остается активным. Эти режимы могут быть назначены как глобально для всей системы, так и индивидуально для отдельных категорий пользователей. **Пропуск:** * *При выдаче временного пропуска* - изымать постоянный пропуск, уазанный в заявке*.* * *Количество бит у кода организации и количество бит у номера пропуска -* укажите количество бит для настройки разрядности. Например, код организации: `8 бит`Номер пропуска: `16 бит` * *Срок действия бессрочного пропуска:* укажите срок действия, который будет назначен бессрочному пропуску из PassOffice при отгрузке в PERCo. Если в PassOffice создан бессрочный пропуск, то в PERCo пропуск будет отгружен со сроком действия, указанным в «Настройках интеграции». **События:** * *Импортировать события доступа начиная с:* определите период времени для синхронизации событий между PassOffice и СКД. Этот параметр определяет, как часто PassOffice будет получать обновления из СКД. * *Конфигурация размера пакетов для импорта:* оптимизируйте процесс импорта данных из СКД, указав размер пакетов для различных типов объектов: человек, группа доступа, сообщение из СКД, считыватель. • **Тест соединения:** обязательно проведите тест соединения после ввода параметров. * **Успешный тест:** активируйте настройки соединения с СКД. * **Ошибка:** проверьте логи СКД *PERCo* и сервера PassOffice для выявления и устранения проблемы. • **Соответствие категорий:** укажите соответствие между категориями пользователей в PassOffice и СКД. {% hint style="info" %} PassOffice подерживает работу только с посетителями в *PERCo.* {% endhint %} • **Настройка полей:** Сконфигурируйте поля человека, доп.поля человека, пропуска, указав какие поля необходимо отгружать или импортировать из СКД, а также стратегию слияния при импорте: * *Сторонняя система, очищать -* если поле есть и в PassOffice и в СКУД, то оно будет заменено на соответствующее из СКУД. Если поле есть в PassOffice, но нет в СКУД, то поле в PassOffice будет очищено. Если каких-то полей нет в PassOffice, но есть в СКУД, то оно заменится на соответствующее из СКУД. * *Сторонняя система, дополнять -* если поле есть и в PassOffice и в СКУД, то оно будет заменено на соответствующее из СКУД. Если поле есть в PassOffice, но нет в СКУД, то поле отгрузится из PassOffice. Если каких-то полей нет в PassOffice, но есть в СКУД, то оно заменится на соответствующее из СКУД. * *Бюро пропусков -* при расхождении данных, поля из PassOffice останутся приоритетными. Если каких-то полей нет в PassOffice, но есть в СКУД, то оно заменится на соответствующее из СКУД. И если есть поля в PassOffice, но нет в СКУД - недостающие поля отгружаются в СКУД. **Поля посетителя, которые синхронизируются с СКД PERCo:** | Поля | Отгрузка в СКД | Импорт из СКД | | :-----------: | :------------: | :-----------: | | ФИО | + | + | | Подразделение | + | + | | Активность | + | + | | Фото | + | + | | Категория | + | + | | Почта | + | + | | Организация | + | + | **Поля пропуска, которые синхронизируются с СКД PERCo:** | Поля | Отгрузка в СКД | Импорт из СКД | | :-------------: | :------------: | :-----------: | | Номер пропуска | + | + | | Код организации | + | + | • **Реактивация/Деактивация соединения:** используйте соответствующие кнопки для управления состоянием соединения с СКД. После выполнения этих шагов интеграция PassOffice с PERCo должна быть настроена. Рекомендуется проверить работоспособность интеграции путем создания тестовой заявки и отслеживания её в системе PERCo. **Особенности работы с PERCo:** 1. **Обязательное поле «Подразделение»**: * Для отгрузки человека в PERCo необходимо указать **Подразделение**. Без этого данные не будут переданы в PERCo. * **Настройка импорта подразделения**: * Импортируйте подразделение из СКУД. * В PassOffice создайте правило для людей: * **Человек. Организация**: Присвоить → Выберите организацию из выпадающего списка. * **Человек. Подразделение**: Присвоить → Выберите подразделение из выпадающего списка. 2. **Импорт людей**: * При импорте посетителей в PassOffice автоматически проставляется **Организация** (существует только в PassOffice). * Подразделение в PassOffice создается с обязательной привязкой к организации. 3. **Группа доступа для посетителей**: * У посетителей может быть назначена **только одна группа доступа**. 4. **Поддерживаемые типы пропусков**: * **Гостевой**: Для временных посетителей. * **Замена**: Замена существующего пропуска (старый деактивируется). * **Заявка на доступ**: Доступ заменяется, а не добавляется к существующему. * **Продление доступа**: Продление срока действия текущего доступа. * **Ограничение:** У человека может быть только один пропуск. 5. **Блокировка и разблокировка**: * Функции блокировки и разблокировки пропуска **не поддерживаются**. --- # 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-integracii-s-skd-perco.md?ask= ``` 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.