# Установка встроенного приложения на 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` — "идентификатор МФУ" в базе ПринтМенеджера.

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

## Настройка теневого копирования

Для МФУ Avision необходимо указывать источник бумаги при теневом копировании. В настройках МФУ на CUPS-сервере укажите "Источник бумаги: Лоток". Если оставить на усмотрение МФУ — он будет искать бумагу в ручной подаче и выдавать ошибку при её отсутствии.

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