# Типовые сценарии

# Как заменить устройство

## Задача
Заменить старое устройство новым — освободить лицензионный слот у старого и активировать его для нового принтера.

## Предусловия
- Новое устройство уже обнаружено мониторингом (имеет серийный номер в списке устройств).
- У вас есть роль с правом управления лицензиями.

## Шаги

1. Откройте **Управление → Устройства → вкладка «Все»**.
2. Раскройте строку старого устройства, нажав иконку «Развернуть».
3. Перейдите на вкладку **«Лицензии»**.
4. Выключите соответствующие лицензии (освободите слоты).
5. Раскройте строку нового устройства.
6. Перейдите на вкладку **«Лицензии»** нового устройства.
7. Включите нужные лицензии (займите слоты).

## Результат
Старое устройство остаётся в статистике и отчётах, но лицензии потреблять не будет. Новое устройство начинает работу под теми же лицензиями.

## Связанные страницы
- Управление устройствами
- Управление лицензиями

# Как посмотреть журнал ошибок по устройству

## Задача
Просмотреть журнал событий конкретного устройства для диагностики ошибок и сбоев.

## Предусловия
- Устройство добавлено в систему и опрашивается.
- Есть доступ к разделу **Управление → Устройства**.

## Шаги

1. Откройте **Управление → Устройства → вкладка «Все»**.
2. Найдите нужное устройство в таблице (используйте фильтры по статусу, локации, IP или строку поиска).
3. Нажмите иконку **«Развернуть»** (стрелки слева от модели) — откроется панель устройства.
4. Перейдите на вкладку **«Журнал»**.
5. Над таблицей выберите нужный период в фильтре по датам.
6. Просмотрите список событий: тип, дата, описание.

## Результат
Отображается хронологический список событий устройства за выбранный период. Критичные события выделены.

## Связанные страницы
- Управление устройствами
- Пороговые значения событий

# Как создать группу устройств

## Задача
Создать группу устройств для использования в отчётах и правилах печати.

## Предусловия
- Устройства уже добавлены в систему.
- Есть права на управление группами.

## Шаги

1. Перейдите в **Управление → Устройства → Группы**.
2. Нажмите **«Добавить группу»** — откроется форма создания.
3. Заполните поля:
   - **Название группы** — обязательное.
   - **Описание** — необязательное.
   - **Принтеры и МФУ** — мультивыбор с поиском по названию устройства, IP-адресу или серийному номеру.
4. В результатах поиска рядом с названием отображается IP для однозначной идентификации моделей.
5. Нажмите **«Сохранить»** — группа появится в списке.

## Результат
Группа создана и доступна в разделе «Группы». Её можно использовать в отчётах (Аналитика → Отчёты → По устройствам) и правилах печати.

## Связанные страницы
- Управление группами устройств
- Правила печати

# Как сбросить PIN пользователю

## Задача
Сгенерировать новый PIN-код одному или нескольким пользователям.

## Предусловия
- Пользователи существуют в системе.
- Есть права на управление пользователями.

## Шаги

### Для одного или нескольких выбранных пользователей

1. Откройте раздел **Управление → Пользователи → вкладка «Все»**.
2. Выберите нужных пользователей с помощью чекбоксов в левой части строк таблицы.
3. В левом нижнем углу таблицы выберите действие **«Сгенерировать PIN-коды»** и нажмите «Применить».
4. В появившемся модальном окне нажмите кнопку **«Сгенерировать»**.

### Для всех пользователей сразу

1. Откройте раздел **Управление → Пользователи**.
2. Нажмите на многоточие рядом с заголовком «Пользователи».
3. Выберите **«Сгенерировать PIN-коды»**.
4. В открывшемся модальном окне нажмите **«Генерировать»**.

## Результат
Новые PIN-коды сгенерированы. Пользователи могут использовать их для авторизации на МФУ.

## Связанные страницы
- Управление пользователями
- Базовые операции

# Как настроить персонализированный отчёт

## Задача
Создать и сохранить пользовательский отчёт с нужными столбцами и фильтрами.

## Предусловия
- Есть доступ к разделу Аналитика → Отчёты.
- Доступность типов отчётов определяется ролью текущего пользователя.

## Шаги

### Вариант 1 — на базе типового отчёта

1. Откройте **Аналитика → Отчёты** и выберите нужный тип (по устройствам, по пользователям и т.п.).
2. Отредактируйте отчёт через иконку **«Шестерёнка»**: настройте видимые столбцы и их порядок.
3. При необходимости примените нужные фильтры.
4. Нажмите **«Сохранить»** и укажите название отчёта.

### Вариант 2 — создание с нуля

1. Нажмите кнопку **«Плюс»** справа от заголовка страницы.
2. Укажите название и тип отчёта.
3. Настройте столбцы аналогично настройке через «Шестерёнку».
4. Нажмите **«Сохранить»**.

## Результат
Отчёт сохранён и появился в списке пользовательских отчётов с указанием типа (на базе какого типового создан). Доступна подписка на автоматическую отправку по расписанию.

## Связанные страницы
- Работа с отчётами

# Как настроить мониторинг по SNMP v3

## Задача
Настроить опрос устройств по SNMP v3 — для всей локации или для конкретного устройства.

## Предусловия
- На МФУ включена приватность SNMPv3 (Security Level: auth-password/priv-password). Пароли идентификации и шифрования должны быть одинаковыми.
- Есть доступ к настройкам локации и/или параметрам устройства.

## Шаги

### Для конкретного устройства

1. Откройте **Управление → Устройства → вкладка «Все»**.
2. Раскройте нужное устройство, нажав иконку «Развернуть».
3. Перейдите на вкладку **«Настройки»** → раздел **«Настройки SNMP v3»**.
4. Заполните поля: **Имя пользователя**, **Пароль аутентификации**, **Пароль шифрования**.
5. Нажмите **«Сохранить»**.

### Для всех устройств локации

1. Перейдите в **панель администратора Мониторинга**.
2. Откройте раздел **«Параметры сканирования сети»**.
3. Нажмите **«Добавить параметры сканирования сети»**.
4. Заполните поля **«Логин SNMP v3»** и **«Пароль SNMP v3»**.
5. Если на МФУ задано Контекстное имя — укажите его в поле **«Контекстное имя»**. Для нескольких разных значений перечислите через запятую.
6. Сохраните настройки.

## Результат
Все принтеры в локации будут опрашиваться только по SNMP v3. Если логин и пароль внесены корректно, данные начнут поступать после следующего цикла опроса.

## Связанные страницы
- Управление устройствами
- Настройки подключения к устройству
- Управление локациями

# Как установить встроенное приложение на МФУ

## Задача
Установить встроенное приложение Принтум на МФУ для авторизации пользователей
и управления заданиями печати.

## Предусловия
- МФУ поддерживает платформу встроенного приложения
- МФУ добавлен в Мониторинг и импортирован в ПринтМенеджер
- Есть лицензия на Встроенное приложение для данного устройства

## Шаги

### Шаг 1. Проверить совместимость
Перейди на страницу "Совместимость встроенного приложения с МФУ" и убедись
что твоя модель поддерживает нужную платформу. Там же указан способ установки.

### Шаг 2. Выбрать инструкцию по вендору

#### Установка по кнопке из Личного кабинета
Эти вендоры поддерживают установку напрямую из интерфейса Принтум:
- HP
- Xerox
- Konica Minolta
- Sharp

#### Установка через загрузку файла на МФУ
Для этих вендоров нужно скачать файл приложения и загрузить его через
веб-интерфейс МФУ:
- Ricoh
- Lexmark / Fplus
- Avision
- Brother
- Epson
- Pantum
- Гравитон

#### Установка с флешки
- Kyocera — приложение устанавливается через USB-флешку

### Шаг 3. Выполнить предварительную настройку МФУ
Перед установкой приложения необходимо настроить само устройство.
Подробные шаги — в инструкции по вашему вендору.

### Шаг 4. Установить приложение
Следуйте инструкции для вашего вендора:
- HP → "Установка встроенного приложения на HP"
- Xerox → "Установка встроенного приложения на Xerox"
- Kyocera → "Установка встроенного приложения на Kyocera"
- Ricoh → "Установка встроенного приложения на Ricoh"
- Konica Minolta → "Установка встроенного приложения на Konica Minolta"
- Sharp → "Установка встроенного приложения на Sharp"
- Lexmark / Fplus → "Установка встроенного приложения на Lexmark и Fplus"
- Brother → "Установка встроенного приложения на Brother"
- Epson → "Установка встроенного приложения на Epson"
- Avision → "Установка встроенного приложения на Avision"
- Pantum → "Установка встроенного приложения на Pantum"

### Шаг 5. Проверить результат
После установки пользователь должен видеть экран авторизации Принтум
при подходе к МФУ.

## Связанные страницы
- Совместимость встроенного приложения с МФУ
- Встроенное приложение — справка по компоненту
- Лицензирование в Принтум

# Как подключить принтер к филиальному ПринтМенеджеру

## Задача
Установить и подключить филиальный ПринтМенеджер к центральному серверу Мониторинга.

## Предусловия
- Центральный сервер Мониторинга уже установлен и доступен.
- Подготовлены собственные SSL-сертификаты (client.crt, client.key, ca.crt) — филиальные ПМы требуют собственных сертификатов.
- Известен IP-адрес центрального Мониторинга (`<ip_M>`) и будущего филиального ПМ (`<ip_PM>`).

## Шаги

1. Выполните команду онлайн-установки на сервере филиального ПМ:

```
sudo curl -L https://s3.printum.io/distrib/printum-printmanager/install.sh   | sudo -E PM_HOSTNAME=<ip_PM> MONITORING_ADDRESS=<ip_M>     SSL_CERT=client.crt SSL_KEY=client.key SSL_CERT_CA=ca.crt bash
```

2. Дождитесь завершения установки.
3. Перейдите в Личный кабинет → **Настройки → Интеграции → ПринтМенеджеры**.
4. Настройте синхронизацию с новым филиальным ПМ согласно разделу **«Интеграция с ПМами»**.

## Результат
Филиальный ПМ подключён к Мониторингу и получает данные о пользователях при синхронизации. Карты авторизации, привязанные пользователями самостоятельно, сохраняются в филиальном ПМе.

## Связанные страницы
- Интеграции
- Управление настройками организации

# Как добавить принтер для прямой печати

## Задача
Добавить принтер на рабочую станцию сотрудника для отправки заданий напрямую, без очереди отложенной печати.

## Предусловия
- ПринтМенеджер установлен и настроен.
- Известен «Идентификатор в CUPS» нужного принтера (указан на странице редактирования принтера в ПМ, раздел «Принтеры»).
- Пользователю или отделу назначены права на прямую печать на этом принтере.

## Шаги

### Добавление принтера на АРМ

1. Добавьте принтер на рабочей станции аналогично отложенной печати.
2. В качестве имени/адреса принтера укажите:
   ```
   https://<адрес_принтменеджера>:1631/printers/<printer_name>_virtual
   ```
   Где `printer_name` — идентификатор в CUPS с добавлением `_virtual` в конце.
   Пример: `https://10.0.132.237:1631/printers/VersaLink_B405_3719401600_virtual`

### Назначение принтера пользователю

1. Перейдите в **панель администратора Мониторинга**.
2. Откройте раздел **«Пользователи»** → найдите нужного пользователя → откройте профиль.
3. Пролистайте до подраздела **«Печать»**.
4. Дважды щёлкните по нужным устройствам, чтобы добавить их в список выбранных.

### Назначение принтера отделу

1. Откройте **«Отделы и группы»** → найдите нужный отдел → откройте профиль.
2. Пролистайте до подраздела **«Разрешенные для прямой печати принтеры»**.
3. Отметьте устройства из списка.

## Результат
Принтер добавлен на рабочую станцию. Пользователь или отдел может отправлять задания на прямую печать без необходимости авторизации на МФУ.

## Связанные страницы
- Управление пользователями
- Управление отделами

# Как настроить удаление невостребованных заданий из очереди

## Задача
Настроить автоматическое удаление заданий печати, которые слишком долго находятся в очереди и не были забраны пользователем.

## Предусловия
- Установлен и синхронизирован ПринтМенеджер.
- Есть права на создание правил печати.

## Шаги

1. Перейдите в **Настройки → Общие → вкладка «Правила печати»**.
2. Нажмите кнопку **«Добавить»**.
3. В открывшемся модальном окне укажите название правила (например, «Удаление заданий из очереди через 1 час»).
4. Выберите действие: **«Отменить задание»**.
5. Нажмите **«+ Новое условие»**.
6. Выберите условие: **«задание находится в очереди»** — укажите время в часах (например, 1).
7. Нажмите **«Ок»** для сохранения условия.
8. Нажмите **«Сохранить»** для сохранения правила.
9. Перейдите на вкладку **«Активность»** в карточке правила и назначьте его на нужных пользователей и/или отделы.

## Результат
Задания, которые находились в очереди дольше указанного времени, автоматически отменяются. Правило применяется только к заданиям, созданным после его активации.

## Связанные страницы
- Правила печати
- Управление заданиями печати

# Как настроить очистку архива

## Задача
Настроить автоматическое удаление старых заданий из архива по истечении заданного срока хранения.

## Предусловия
- Установлен и синхронизирован ПринтМенеджер.
- Есть доступ к AdminPanel ПМ: `https://<адрес_принтменеджера>:8080/config`.
- Есть права на создание правил печати.

## Шаги

### Ограничить место под архив

1. Откройте ПринтМенеджер → **Настройки** (`https://<адрес_принтменеджера>:8080/config/constance/config/`).
2. Откройте подменю **«Настройки очереди печати и архива заданий»**.
3. Укажите параметры:
   - **ARCHIVE_FREE_SPACE** — размер свободного места (МБ), ниже которого запускается освобождение.
   - **ARCHIVE_SIZE_DELETE** — сколько места освободить при переполнении (рекомендуется оставить по умолчанию).
   - **ARCHIVE_CHECKS_PERIOD_HOURS** — интервал проверки свободного места (в часах).
4. Сохраните настройки.

### Настроить срок хранения через правило

1. Перейдите в Личный кабинет → **Настройки → Общие → Правила печати**.
2. Нажмите **«Добавить»**.
3. Укажите название (например, «Очистка архива старше 90 дней»).
4. Выберите действие: **«Удалить образ документа»**.
5. Нажмите **«+ Новое условие»** → выберите **«Время хранения в архиве»** → укажите количество дней.
6. Нажмите **«Ок»**, затем **«Сохранить»**.
7. На вкладке **«Активность»** назначьте правило на нужных пользователей или отделы.

## Результат
Задания старше указанного срока автоматически удаляются из архива. При нехватке места запускается дополнительная очистка по настройкам ARCHIVE_FREE_SPACE.

## Связанные страницы
- Правила печати
- Управление заданиями печати

# Как исключить определённых пользователей из архива заданий

## Задача
Настроить правило, при котором задания печати определённых пользователей не сохраняются в архиве (или образ сразу удаляется).

## Предусловия
- Установлен и синхронизирован ПринтМенеджер.
- Есть права на создание правил печати.

## Шаги

1. Перейдите в **Настройки → Общие → вкладка «Правила печати»**.
2. Нажмите **«Добавить»**.
3. Укажите название (например, «Не архивировать — VIP пользователи»).
4. Выберите действие: **«Удалить образ документа»** — образ документа удаляется из архива сразу после печати.
5. При необходимости добавьте условия (например, ограничение по группе принтеров).
6. Нажмите **«Сохранить»**.
7. Перейдите на вкладку **«Активность»** и назначьте правило на конкретных пользователей или отделы, которые нужно исключить из архивирования.

## Результат
Для назначенных пользователей образы документов удаляются и не хранятся в архиве. Сами задания (метаданные) по-прежнему видны в журнале.

## Связанные страницы
- Правила печати
- Управление пользователями
- Управление заданиями печати

# Как посмотреть самые нагруженные устройства в локации

## Задача
Найти устройства с наибольшим объёмом печати в заданной локации за выбранный период.

## Предусловия
- Есть доступ к разделу **Аналитика → Отчёты**.
- Устройства привязаны к локациям.

## Шаги

1. Откройте **Аналитика → Отчёты → По устройствам**.
2. Примените фильтр **«Локация»** — выберите нужную локацию.
3. Задайте период отчёта (фильтр по дате).
4. Нажмите на заголовок столбца с нужным показателем (например, «Страниц всего») для сортировки по убыванию.
5. Устройства с наибольшей нагрузкой окажутся в верхней части таблицы.
6. Опционально: нажмите иконку «Шестерёнка» и добавьте нужные столбцы (цветные страницы, копирование, сканирование).

## Результат
Список устройств отсортирован по объёму печати. Можно скачать отчёт в Excel или сохранить как пользовательский.

## Связанные страницы
- Работа с отчётами
- Управление локациями

# Как исключить устройство из мониторинга

## Задача
Временно или постоянно остановить опрос устройства системой мониторинга, не удаляя его из базы.

## Предусловия
- Устройство добавлено в систему.
- Есть права на управление устройствами и настройками локации.

## Шаги

1. Откройте **Управление → Устройства → вкладка «Все»**.
2. Раскройте нужное устройство, нажав иконку «Развернуть».
3. Перейдите на вкладку **«Параметры»**.
4. _TODO: уточнить конкретный шаг_ — найдите параметр, отвечающий за включение/отключение опроса устройства.
5. Сохраните изменения.

**Альтернативный способ — через настройки локации:**

1. Перейдите в **Управление → Локации**.
2. Откройте карточку нужной локации.
3. Перейдите на вкладку **«Управление сканированием и опросом»**.
4. _TODO: уточнить конкретный шаг_ — отключите опрос для нужного диапазона IP или конкретного устройства.
5. Сохраните изменения.

## Результат
Устройство больше не опрашивается. Исторические данные и статистика сохраняются. Устройство остаётся в списке со статусом «нет данных» (серый цвет после 72 часов без данных).

## Связанные страницы
- Управление устройствами
- Управление локациями

# Как скрыть устройства без данных

## Задача
Скрыть из списка устройства, по которым длительное время нет данных (серый статус), чтобы они не засоряли рабочие представления.

## Предусловия
- Есть доступ к разделу **Управление → Устройства**.

## Шаги

1. Откройте **Управление → Устройства → вкладка «Все»**.
2. В строке фильтров найдите фильтр по **«Статусу»**.
3. Снимите отметку со статуса **«Нет данных»** (серый) или выберите только активные статусы (синий, жёлтый, красный).
4. Таблица обновится — устройства без данных будут скрыты.

**Для сохранения фильтра как постоянного отображения:**

- _TODO: уточнить конкретный шаг_ — сохраните текущий вид как пользовательский (если функционал доступен в вашей версии).

**Настройка порога «нет данных»:**

- По умолчанию устройство переходит в серый статус через **72 часа** без данных. Этот интервал можно изменить в настройках пороговых значений событий (**Настройки → Пороговые значения событий**).

## Результат
В рабочем списке отображаются только устройства с актуальными данными. Устройства без данных не удалены и доступны при снятии фильтра.

## Связанные страницы
- Управление устройствами
- Пороговые значения событий

# Как перейти в веб-интерфейс устройства из Личного кабинета

## Задача
Открыть встроенный веб-интерфейс МФУ прямо из карточки устройства в Личном кабинете, не вводя IP вручную в браузере.

## Предусловия
- Устройство добавлено в систему и опрашивается (имеет IP-адрес).
- Веб-интерфейс МФУ доступен в сети с рабочей станции пользователя.

## Шаги

1. Откройте **Управление → Устройства → вкладка «Все»**.
2. Найдите нужное устройство и убедитесь, что в столбце **«IP-адрес»** отображается актуальный адрес.
3. Раскройте строку устройства, нажав иконку «Развернуть».
4. В панели устройства найдите ссылку или кнопку для перехода на веб-интерфейс устройства (отображается в области с общей информацией: модель, локация, IP).
5. _TODO: уточнить конкретный шаг_ — нажмите на IP-адрес или соответствующую кнопку для перехода.
6. В новой вкладке браузера откроется веб-интерфейс МФУ.

## Результат
Веб-интерфейс устройства открыт. Можно проверить статус расходных материалов, настройки сети и другие параметры непосредственно на устройстве.

## Связанные страницы
- Управление устройствами
- Просмотр данных по устройству

# Как настроить драйвер для конкретного принтера

## Задача
Назначить или сменить драйвер и протокол подключения, используемые при отправке задания на конкретное сетевое устройство.

## Предусловия
- Устройство является сетевым (управление драйверами доступно только для сетевых устройств).
- Установлен и синхронизирован ПринтМенеджер.
- Есть права на редактирование устройств.

## Шаги

1. Откройте **Управление → Устройства → вкладка «Все»**.
2. Раскройте нужное сетевое устройство, нажав иконку «Развернуть».
3. Перейдите на вкладку **«Драйвер»**.
4. Нажмите поле **«Драйвер»** и начните ввод названия (поиск активируется с 3-го символа).
5. Выберите нужный драйвер из выпадающего списка.
6. При необходимости измените **«Протокол»** из выпадающего списка. Поддерживаемые протоколы по вендорам:
   - **HP, Kyocera, Pantum, Sharp, Sindoh** — socket
   - **Konica Minolta, Xerox** — socket, ipp
   - **Avison, Brother, Epson, f+imaging, Lexmark, Ricoh** — socket, http
7. Поле **«Путь подключения»** обновится автоматически при смене протокола.
8. Нажмите **«Сохранить»**.

## Результат
После следующей синхронизации Мониторинга и ПринтМенеджера устройству будет назначен выбранный драйвер. Аналогичным образом может быть изменён протокол.

## Связанные страницы
- Управление устройствами
- Интеграции