История страницы
Удалить страницы Версия 1 (Net)
Группа действий: PDF
...
Описание
Действие удаляет указанный диапазон страниц из PDF-документа.
Для работы с действием необходимо указать контекст PDF-документа. Пользователь может удалить как одну страницу из PDF-документа, указав для этого в параметре "Диапазон страниц" нужную страницу, так и диапазон страниц, указав в параметре "Диапазон страниц" нужный диапазон страниц. Диапазоном страниц может быть два числа через "-", при этом второе число должно быть больше первого. Пробелы не допускаются. Пример заполнения: "11-25", "1-3", "22".
У параметра "Диапазон страниц" есть кнопка плюса, при нажатии на которую появляются новые параметры "Диапазон страниц 1", "Диапазон страниц 2", "Диапазон страниц 3" и т.д. в зависимости от количество нажатий.
Иконка
Параметры
Входные параметры
Иконка действия
Параметры и их настройки
...
Свойство | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
Параметры | ||||
Контекст |
Контекст действия для работы с PDF-документом |
...
Диапазон страниц Диапазон страниц, которые будут удалены из PDF-документа. Диапазоном страниц может быть число или два числа через "-", при этом второе число должно быть больше первого. Пример заполнения: "1-5" или "6".
...
Экземпляр PDF | Да | ||
Имя файла |
Название файла PDF-документа с удаленными страницами. Если поле останется пустым, будет использовано имя исходного файла |
...
Строка | Нет | ||
Путь к |
...
папке | Путь к папке, в которую будет сохранен файл PDF-документа с удаленными страницами. |
...
Если поле останется пустым, то файл сохранится в исходной папке |
...
Путь к папке | Нет | ||
Перезаписать | Если значение "true", и в указанной папке существует PDF-документ с таким же именем, то новый файл его перезапишет. Если |
...
"false", документ перезаписан не будет и действие вернет ошибку |
...
Свойство
Описание
Тип
Удалить страницы
Действие удаляет указанный диапазон страниц из PDF-документа.
Контекст
Контекст действия для работы с PDF-документом.
Экземпляр PDF
Выходные параметры
Результат Путь к файлу PDF-документа с удаленными страницами.
Настройки
Логический | Нет |
Диапазон страниц | Диапазон страниц, которые будут удалены из PDF-документа. Диапазоном страниц может быть число или два числа через "-", при этом второе число должно быть больше первого. Пример заполнения: "1-5" или "6". Клонируемый параметр |
Строка | Да |
Имя файла
Название файла PDF-документа с удаленными страницами. Если поле останется пустым, будет использовано имя исходного файла.
Строка
Путь к папке
Путь к папке
Перезаписать
Если значение «true», и в указанной папке существует PDF-документ с таким же именем, то новый файл его перезапишет. Если «false», документ перезаписан не будет и действие вернет ошибку.
Логический
Результаты | ||||
Результат | Путь к файлу PDF-документа с удаленными страницами |
Путь к файлу |
Особые условия использования
- Если один из параметров диапазона некорректно заполнен, то действие бросает ошибку. Тип исключения: Robin.Exception.ValidationError. Описание ошибки: "Некорректно заполнен диапазон страниц.".Если в параметрах диапазона указаны несуществующие страницы, то действие удалит страницы с первой указанной и по последнюю страницу из документа. Пример
Пример: В документе 20 страниц. Указанный диапазон: "15-30". Действие удалит страницы с 15 по 20. - Нельзя удалить все страницы PDF-документа - действие бросит выдаст ошибку. Тип исключения: Robin.Exception.ValidationError. Описание ошибки: "Нельзя удалить все страницы PDF-документа.".
- Пример 1: В документе 5 страниц. "Диапазон страниц"- "1-5".
- Пример 2: В документе 5 страниц. "Диапазон страниц" - "1-3". "Диапазон страниц 1" - "4-5".
- Пример 3: В документе 1 страница. "Диапазон страниц" - "1".
- Пользователь может поменять название и путь для сохранения PDF-документа с удаленными страницами.
- Если пользователь не укажет имя файла, то сохранится исходное имя файла.
- Если пользователь не укажет путь к папке, то файл сохранится в исходной папке.
- Если пользователь укажет имя файла, но не укажет путь к папке, то файл будет сохранен с указанным именем в исходной папке.
- Если пользователь укажет путь к папке, но не укажет имя файла, то в указанной папке будет сохранен файл с исходным названием.
- Пользователь может переписать файл: если значение параметра перезаписи «true», и в указанной папке существует файл с таким же именем и расширением, то новый файл его перезапишет. Если «false», файл перезаписан не будет и действие бросит ошибку. Тип исключения: Robin.Exception.FileAlreadyExists. Описание ошибки: "PDF-документ с указанным именем уже существует.".
- Результатом действия будет путь к PDF-документу с удаленными страницами. Исходный документ действие не меняет, а создает на его основе копию, содержащую изменения.
Пример использования
Задача
Решение
...
Пример использования
Задача
Есть PDF-файл с 5 страницами.
Необходимо удалить первые две страницы, заменить имя файла на "Новый PDF" и сохранить его в другую папку.
Решение
Воспользоваться действиями "Открыть" и "Удалить страницы".
Реализация
- Собрать следующую схему робота, состоящую из следующих действий.
- Настроить параметры для действия "Открыть".
- Настроить параметры для действия "Удалить страницы".
- Запустить робота, нажав на кнопку "Старт" в верхней панели.
Результат
Программный робот отработал успешно. Имя и путь файла были изменены.
Из файла были удалены первые 2 страницы.