Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

...

Действие удаляет указанный диапазон страниц из PDF-документа.

Для работы с действием необходимо указать контекст PDF-документа. Пользователь может удалить как одну страницу из PDF-документа, указав для этого в параметре "Диапазон страниц" нужную страницу, так и диапазон страниц, указав в параметре "Диапазон страниц" нужный диапазон страниц. Диапазоном страниц может быть два числа через "-", при этом второе число должно быть больше первого. Пробелы не допускаются. Пример заполнения: "11-25", "1-3", "22".

У параметра "Диапазон страниц" есть кнопка плюса, при нажатии на которую появляются новые параметры "Диапазон страниц 1", "Диапазон страниц 2", "Диапазон страниц 3" и т.д. в зависимости от количество нажатий.

Иконка

Image Added

...

Параметры

Входные параметры

...

Имя файла                    Название  Название файла PDF-документа с удаленными страницами. Если поле останется пустым, будет использовано имя исходного файла.

Путь к папке                 Путь   Путь к папке, в которую будет сохранен файл PDF-документа с удаленными страницами. Если поле останется пустым, то файл сохранится в исходной папке.

Перезаписать               Если   Если значение «true», и в указанной папке существует PDF-документ с таким же именем, то новый файл его перезапишет. Если «false», документ перезаписан не будет и действие вернет ошибку.

Выходные параметры

Результат                      Путь к файлу PDF-документа с удаленными страницами.

Настройки

Удалить страницы

Свойство

Описание

Тип

Пример заполненияОбязательность заполнения поля
Параметры

Действие удаляет указанный диапазон страниц из PDF-документа.

Контекст

Контекст действия для работы с PDF-документом.

Экземпляр PDF

Да

Диапазон страниц

Диапазон страниц, которые будут удалены из PDF-документа. Диапазоном страниц может быть число или два числа через "-", при этом второе число должно быть больше первого. Пример заполнения: "1-5" или "6". Клонируемый параметр.Строка


Да

Имя файла

Название файла PDF-документа с удаленными страницами. Если поле останется пустым, будет использовано имя исходного файла.

Строка


Нет

Путь к папке

Путь к папке, в которую будет сохранен файл PDF-документа с удаленными страницами. Если поле останется пустым, то файл сохранится в исходной папке.

Путь к папке


Нет

Перезаписать

Если значение «true», и в указанной папке существует PDF-документ с таким же именем, то новый файл его перезапишет. Если «false», документ перезаписан не будет и действие вернет ошибку.

Логический


Нет

Диапазон страниц

Диапазон страниц, которые будут удалены из PDF-документа. Диапазоном страниц может быть число или два числа через "-", при этом второе число должно быть больше первого. Пример заполнения: "1-5" или "6". Клонируемый параметр.

Строка


Да
Результаты

Результат

Путь к файлу PDF-документа с удаленными страницами.

Путь к файлу



Особые условия использования

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

Если указать имя файла и путь к папке, то необходимо заполнить "Перезаписать" = true для перезаписи существующего файла, иначе действие бросит ошибку.

Пример  использования 

Задача

Решение

...

  1. Пользователь может удалить как одну страницу из PDF-документа, указав для этого в параметре "Диапазон страниц" нужную страницу, так и диапазон страниц, указав в параметре "Диапазон страниц" нужный диапазон страниц. Диапазоном страниц может быть два числа через "-", при этом второе число должно быть больше первого. Пробелы не допускаются. 
    1. Пример: "11-25", "1-3", "22".
  2. У параметра "Диапазон страниц" есть кнопка плюса, при нажатии на которую появляются новые параметры "Диапазон страниц 1", "Диапазон страниц 2", "Диапазон страниц 3" и т.д. в зависимости от количество нажатий.

Пример  использования 

Задача

Есть PDF-файл с 5 страницами:

Image Added

Необходимо удалить первые две страницы, заменить имя файла на "Новый PDF" и записать его в другую папку.

Решение

Воспользоваться действиями "Открыть" и "Удалить страницы".

Реализация

  1. Собрать следующую схему робота, состоящую из следующих действий:
    Image Added

  2. Настроить параметры для действия "Открыть":
    Image Added

  3. Настроить параметры для действия "Удалить страницы":
    Image Added

  4. Запустить робота, нажав на кнопку "Старт" в верхней панели. 

Результат

Программный робот отработал успешно. Имя и путь файла были изменены.

Image Added

Из файла были удалены первые 2 страницы:

Image Added