Установка PassportBox

Инструкция по установке и настройке драйвера PassportBox в PassOffice

1. Установка драйвера PassportBox

Запустите инсталлятор PassOffice
- Выберите компонент "Драйвер PassportBox"
- При установке автоматически будет установлен RabbitMQ (если не был установлен ранее).
Проверьте установку
- Драйвер появится в списке служб Windows:
  - Driver Manager
  - RabbitMQ

2. Настройка режима работы PassportBox

Файл конфигурации:

[PassOffice]\WebDrivers\Settings\ApcApplRes\ApcWebDrvManager\ApcWebDrvManager_defaultCfg.ini

Режимы работы (секция ApcPassportBox)

ApcPassportBox_mode=0  # Режим работы (0, 1 или 2)

0 – Стандартный режим (через HTTP-запросы, рекомендуется для PassOffice).
1 или 2 – Автоматическая отправка сканов через WebSocket (используется для Терминала саморегистрации).

Настройки RabbitMQ (обязательные)

rabbit_producer_routing_key_prefix=apc.wdm.passportbox  
rabbit_ip=localhost  
rabbit_port=5672  
rabbit_login=guest  
rabbit_password=guest  
rabbit_channel=1  
rabbit_exchange=apc.wdm.passportbox  
rabbit_exchange_type=topic  
rabbit_exchange_durable=1  
rabbit_queue=apc.wdm.passportbox  

3. Запуск и настройка в PassOffice

Запустите службу
- Откройте Службы Windows (services.msc).
- Запустите Driver Manager.
Включите распознавание в PassOffice
- Перейдите: Конфигурирование → Настройки → Корневые настройки → Вкладка "Документы".
- Активируйте "Распознавание документов" и выберите "PassportBox".
- Укажите URL сервиса:
```
http://localhost:7010/v1/PassportBox/v2
```

4. Калибровка сканера PassportBox

Подготовьте тестовую картинку
- Распечатайте тестовое изображение (см. "Приложение" в документации PassportBox).
Запустите калибровку
- Нажмите Ctrl + R в интерфейсе сканирования.
- Поместите тестовую картинку в сканер по инструкции.
Проверьте результат
- Если распознавание нечеткое – повторите калибровку.

5. Использование сканера в PassOffice

Способы сканирования

Через иконку "Сканирование"
- В правом верхнем углу нажмите "Сканирование" → выберите PassportBox → "Сканировать".
При создании заявки
- В разделе "Мои заявки" → нажмите "Сканировать" → проверьте данные → добавьте в заявку.
При выдаче пропуска
- В выпадающем меню выберите "Отсканировать посетителя" → внесите данные.

6. Настройка пользователя RabbitMQ

Когда использовать guest?

Если PassOffice, RabbitMQ и PassportBox работают на одном ПК.

Создание отдельного пользователя (рекомендуется)

Откройте веб-интерфейс RabbitMQ:
```
http://localhost:15672
```
Войдите под guest/guest.
Перейдите: Admin → Add User → задайте логин/пароль.
Назначьте роль administrator.

Обновите настройки в ApcWebDrvManager_defaultCfg.ini:

rabbit_login=новый_логин  
rabbit_password=новый_пароль  

7. Проверка работы

Тестовое сканирование
- Убедитесь, что данные документа (ФИО, номер и т.д.) корректно распознаются.
Проверка RabbitMQ
- В веб-интерфейсе (http://localhost:15672) проверьте:
  - Queues (очереди apc.wdm.passportbox).
  - Connections (активные подключения).

8. Возможные проблемы и решения

Проблема	Решение
Сканер не отвечает	Проверьте подключение и калибровку.
Ошибка RabbitMQ	Убедитесь, что служба запущена и пользователь существует.
Данные не распознаются	Повторите калибровку или проверьте тестовую картинку.

Проблемы с RabbitMQ

Пользователь не добавлен
- Проверьте список пользователей:
```
rabbitmqctl.bat list_users
```
- Добавьте пользователя:
```
rabbitmqctl.bat add_user username password
```
- Обновите данные о пользователе в файле конфигурации:
```
WebDrivers\Settings\ApcApplRes\ApcWebDrvManager\ApcWebDrvManager_defaultCfg.ini
```
Ошибка подключения (Invalid challenge reply)
- Проверьте файлы .erlang.cookie в:
  - C:\Windows\System32\config\systemprofile
  - C:\Users\[Ваш_пользователь]
- Убедитесь, что их содержимое идентично. Если это не так, перенесите его из папки System32 вручную в папку текущего пользователя.
- Перезапустите сервис RabbitMQ.

Инструкция по установке и настройке драйвера PassportBox в PassOffice​

Инструкция по установке и настройке драйвера PassportBox в PassOffice