II.3 Задачи, параметры и результаты
Задача — это обещание из трёх частей
Когда вы нажимаете кнопку запуска, Documentize создаёт задачу. Представьте задачу как наряд на работу, переданный специалисту:
ВХОД ПАРАМЕТРЫ РЕЗУЛЬТАТ
ваши файлы + несколько выборов -> новые файлы
(не меняются) (значения готовы) (хранятся некоторое время)
Специалист (исполнитель, выделенный под это приложение) берёт наряд из очереди, делает одну работу и кладёт готовые файлы на полку, чтобы вы их забрали. Поэтому тяжёлые задачи показывают ход выполнения, а не «замораживают» страницу, и поэтому ту же работу можно запускать из скрипта или от ИИ-ассистента: это просто задача с номером.
Параметры: обязательные, необязательные, со значением по умолчанию
Параметры бывают трёх видов.
| Вид | Пример | Что делать |
|---|---|---|
| Обязательны для старта | Разблокировке нужен пароль. Цифровой подписи нужны сертификат .pfx и его пароль. Удалению страниц нужны страницы для удаления. Добавлению содержания нужны записи, которые вы вводите | Приложение не может угадать. Оно скажет, чего не хватает (например, «Пожалуйста, введите пароль.») |
| Выбор со значением по умолчанию | Уровень сжатия (заранее выбран «Средняя»); язык документа при OCR (английский); стиль Abstracts | Не трогайте, пока результат не окажется не тем, что вы хотели |
| Переключатели, добавляющие работу | OCR при объединении; ИИ-коррекция в PDF с возможностью поиска; параметры санитизации в Recovery | По умолчанию выключены. Включайте, когда знаете зачем |
Панель параметров намеренно спрятана за кнопкой Показать все настройки. Хорошее значение по умолчанию означает, что простое нажатие кнопки — разумная первая попытка.
«Что изменится, если я поменяю это?»
Задавайте этот вопрос о каждом параметре. Несколько реальных примеров из глав показывают, насколько различаются ответы:
| Приложение | Параметр | Что на самом деле меняется |
|---|---|---|
| Сжатие PDF (Compressor) | Низкая / Средняя / Высокая (Low / Medium / High) | Только потолок разрешения для картинок (150, 120 или 96 DPI). Текст остаётся чётким. Чем выше уровень, тем меньше и мягче файл |
| Объединение файлов (Merger) | Режим Последовательный / Сетка (Sequential / Grid) | Как раскладываются изображения. PDF по-прежнему идут один за другим |
| PDF с возможностью поиска (Searchable) | Язык документа | Какой алфавит и какие слова ожидает распознавание. Неверный язык — самая частая причина абракадабры |
| Abstracts | Стиль, длина, язык | Что модели велено написать. Число предложений — это указание, а не гарантия |
| Протектор PDF (Protector) | Пароль | Кто может открыть файл. Прочитать пароль из результата нельзя |
Если параметр рискованный или необратимый, глава о приложении говорит об этом в разделах «Параметры подробно» и «Типичные ошибки и их исправление».
Что вы получаете: результаты
Результат — это новые файлы. Ни одно приложение не изменяет ваш оригинал; это верно для всех глав всех семейств.
Типичные формы результата:
| Форма | Примеры |
|---|---|
| Один PDF | Объединение файлов, Ротация PDF, Уплощение PDF, Добавить содержание в PDF |
| Много файлов в ZIP | Разделение PDF, Сжатие PDF при нескольких входных файлах, Конвертер при нескольких входных файлах, Парсер PDF |
| Другой формат | Извлечь текст (.txt), Извлечение данных формы (CSV), PDF Knowledge Base (ZIP с Markdown) |
| Отчёт | PDF/A Validator, Recovery (исправленный PDF и отчёт) |
| Вердикт на экране | Проверка подписи |
| Беседа | Ask PDF (ответы со ссылками на источники), Assembly Chat |
| Pull request | Repo Docs, Refactor Assistant, NuGet Updater (в режиме применения) |
Имена файлов
Имена результатов обычно повторяют оригинал с суффиксом, либо ZIP называется по операции. Наблюдаемые примеры: …_optimized.pdf, …_cheat_sheet, Compressed_documents, Converted_<from>_to_<to>. Точное имя может отличаться от приложения к приложению; смотрите раздел «Что вы получаете» в главе.
Что результат вам сообщает
Некоторые приложения дают цифры: Сжатие PDF показывает исходный размер, новый размер, сэкономленные байты и процент и честно сообщает о небольшой или даже отрицательной экономии. Другие показывают, что они сделали, по шагам. Прочитайте сводку, прежде чем строить что-то на этом файле.
Иногда результаты частичные
На бесплатном тарифе длинная задача может остановиться по лимиту времени. Вы всё равно получите настоящий результат для файлов, которые успели обработать, и способ закончить остальное. См. II.4.
Переделывайте, а не латайте
Поскольку каждый запуск начинается с вашего оригинала и создаёт новый файл, самый дешёвый способ исправить плохой результат — запустить снова с другими параметрами, исходя из оригинала. Не пропускайте результат с потерями через то же приложение с потерями второй раз. Сжать дважды не значит лучше, а только размытее (Сжатие PDF).
Номера задач, другие каналы
У той же задачи есть номер. В API идентификатор задачи — это способ спросить «готово ли?» и затем скачать результат; в каналах MCP и CLI та же идея. Подробности — в разделе За пределами браузера. В веб-приложении вы редко видите этот номер, но именно благодаря ему результаты можно получать и удалять по отдельности.
Попробуйте
Запустите Сжатие PDF дважды на одном и том же PDF, один раз на уровне «Низкая» и один раз на «Высокая», оба раза от оригинала. Сравните размеры файлов и увеличьте фотографию до 200%. Вы только что узнали, что делает параметр, не заглядывая внутрь.