> 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/skanirovanie/regula-integration.md).

# Установка Regula

**1. Установка Regula Document Reader SDK**

1. **Скачивание дистрибутива**
   * Перейдите на сайт [Regula Forensics](https://regulaforensics.com/).
   * Скачайте **Regula Document Reader SDK версии 7.4.0**.
2. **Установка**
   * Запустите инсталлятор.
   * По умолчанию программа устанавливается в:
     * `C:\Program Files (x86)\Regula\Document Reader SDK` (для 32-разрядных систем)
     * `C:\Program Files\Regula\Document Reader SDK` (для 64-разрядных систем)
3. **Проверка работы сканера**
   * Убедитесь, что в сканере **нет документов**.
   * Подключите сканер к компьютеру.
   * Запустите утилиту **Document Reader** (Пуск → Regula → Document Reader).
   * Нажмите **«Connect»**, поместите документ в сканер → **«Process»**.
   * Проверьте качество распознавания в **трех режимах освещения** (ИК, УФ, видимое).
4. **Калибровка сканера (при необходимости)**
   * Нажмите **Ctrl + R**.
   * Распечатайте **две тестовые картинки** (см. раздел «Приложение» в документации Regula).
   * Поочередно поместите их в сканер по инструкции программы.
   * После калибровки повторно проверьте качество сканирования.
5. **Закрытие утилиты**
   * Утилита **Document Reader** не закрывается через крестик, а сворачивается в трей.
   * Для выхода: **File → Exit**.

**2. Установка драйверов и RabbitMQ**

1. **Установка через PassOffice**
   * Запустите инсталлятор PassOffice.
   * Выберите компоненты:
     * **Драйвер Regula**
     * **RabbitMQ**
2. **Настройка пути к Regula SDK**
   * Откройте файл:

     ```
     C:\Program Files (x86)\PassOffice\%BUILD_VERSION%\Settings\ApcRegulaDrvSettings.ini
     ```
   * Укажите путь к Regula SDK:

     ```
     pathToRegulaDLL=C:\Program Files\Regula\Document Reader SDK
     ```
3. **Запуск службы менеджера драйверов**
   * Откройте **Службы Windows** (`services.msc`).
   * Найдите и запустите **Driver Manager**.

**3. Настройка интеграции в PassOffice**

1. **Включение распознавания документов**
   * Перейдите в **Конфигурирование → Настройки → Корневые настройки**.
   * Откройте вкладку **«Документы»**.
   * Активируйте **«Распознавание документов»** и выберите **Драйвер Regula**.
2. **Настройка подключения к RabbitMQ**
   * Укажите:
     * **URL сервиса**: `http://localhost:7010/v1/regula`
     * **WebSocket (WS)**: `ws://localhost:15674/ws/`
     * **Логин/пароль RabbitMQ**: `guest/guest` (по умолчанию)

{% hint style="info" %}
*Вы можете использовать пользователя по умолчанию - guest/guest, если PassOffice, Driver Manager и RabbitMQ запущены на одной машине и доступны в одной сети*
{% endhint %}

3. **Создание пользователя RabbitMQ (при необходимости)**

* Откройте веб-интерфейс RabbitMQ: [http://localhost:15672](http://localhost:15672/).
* Войдите под `guest/guest`.
* Перейдите в **Admin → Add User**.
* Укажите **логин**, **пароль** и роль **administrator**.
* Обновите данные в **Настройках операторов PassOffice**.

4. **Искать документ после сканирования** - если активирована данная настройка, то после сканирования появится кнопка «Поиск заявки».

**4. Решение возможных проблем**

**Ошибки инициализации Regula**

1. **DriverManager не запускается**
   * Убедитесь, что он находится в **папке без пробелов и русских букв**.
2. **Конфликт с другими приложениями**
   * Закройте все программы, работающие с Regula (например, Document Reader).
3. **Сканер не отвечает**
   * Проверьте подключение и отсутствие документов в сканере.

#### **Проблемы с RabbitMQ**

1. **Пользователь не добавлен**
   * Проверьте список пользователей:

     ```
     rabbitmqctl.bat list_users
     ```
   * Добавьте пользователя:

     ```
     rabbitmqctl.bat add_user username password
     ```
   * Обновите данные о пользователе в файле конфигурации:

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.aamsystems.ru/passoffice/passoffice-guide/admin-guide-doc/skanirovanie/regula-integration.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.