# Установка встроенного приложения на Avision

## Общие сведения

Все файлы, необходимые для установки приложения, передаются в комплекте поставки ПО или по запросу в службу технической поддержки.

## Обновление прошивки

Установка осуществляется через веб-консоль МФУ. В первую очередь необходимо обновить прошивку устройства.

Минимальная версия прошивки:
`AM7630i_SPF_UI07104_FW527_20230208(BUSINESS3.0_RU).spf` от 09.02.2023.

Для обновления выберите "Свойства" > "Обновление прошивки", выберите соответствующий файл `*.spf` (например, `AM7640i_SPF_UI07104_FW527_20230208(BUSINESS3.0_RU).spf`) и нажмите "Обновить".

## Обновление списка разрешённых приложений

После перезагрузки МФУ установите список разрешённых приложений: "Свойства" → "Настройка белого списка приложений" — выберите файл из комплекта поставки с "whitelist" в названии (например, `mfp_whitelist_printum_encrypt_20230117.spf`) и нажмите "Обновить".

## Установка приложения

Выберите "Свойства" → "Установка/удаление приложений". Выберите файл приложения `*.apk` из комплекта поставки (например, `printum-1.0.0.apk`) и нажмите "Установить".

После установки приложение появится в таблице снизу.

## Установка приложения как окна по умолчанию

Для блокировки функционала МФУ для неавторизованного пользователя установите приложение как окно по умолчанию (Default UI):

В окне "Установка/удаление приложений" перейдите на вкладку "Set App as Default UI":
- Введите `com.printum.avision` в поле "App Package Name".
- Поставьте галочку в чекбоксе "Enable".
- Нажмите "Обновить".

Перезагрузите МФУ. Приложение Printum запустится автоматически.

> **Примечание:** Если приложение не установлено как окно по умолчанию, при старте в верхнем левом углу экрана появляется синяя стрелка, которая позволяет вернуться в основной экран МФУ. Синей стрелки не будет, если приложение установлено по умолчанию.

## Настройка приложения

Предварительно сгенерируйте токен приложения: в Личном кабинете перейдите в "Управление" → "Устройства", выберите МФУ, введите и сохраните логин и пароль на вкладке "Настройки", затем нажмите "Токен не сгенерирован" → "Сгенерировать токен".

После первого запуска приложения на самом МФУ нажмите на три точки в верхнем правом углу и выберите "Адрес сервера печати". Введите адрес ПринтМенеджера: `https://<ip_PM>:<port_https>` или `http://<ip_PM>:<port_http>`.

Например: `https://10.0.0.1:8080` или `http://10.0.0.1:8010`.

После ввода адреса ПринтМенеджера введите цифровой пароль для получения токена.

Цифровой пароль генерируется командами на сервере:

```
cd /opt/printmanager
sudo docker-compose exec app bash
python ./manage.py avision_unlock <id_printer>
```

где `id_printer` — идентификатор принтера в ПринтМенеджере, го можно посмотреть в административной панели ПринтМенеджера, в разделе "Управление печатью" → "Принтеры".

После ввода цифрового пароля приложение получит токен, запросит конфигурацию ПринтМенеджера и отобразит сообщение о готовности к работе.

## Копирование в приложении

Если требуется копировать документы разного формата при теневом копировании — копируйте оригиналы каждого формата отдельно с выбором необходимого формата копии. Разделение по форматам в рамках одного задания на текущий момент не реализовано.