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

Ключ

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

Удалить страницы Версия 1 (Net)

Группа действий: PDF 

...

Описание

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

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

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

Иконка

Параметры

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

Иконка действия

Image Added

Параметры и их настройки

...

Свойство

Описание

Тип

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

Контекст

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

...

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

...

Экземпляр PDF


Да

Имя файла

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

...

Строка


Нет

Путь к

...

папке

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

...

 Если поле останется пустым, то файл сохранится в исходной

...

папке

Путь к папке


Нет

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

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

...

"false", документ перезаписан не будет и действие вернет ошибку

...

Название

Обязательное

Описание

Тип данных

Обязательное

Действие

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

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

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

Контекст

Да

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

Экземпляр PDF

Да

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

Да

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

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

Настройки

Логический


Нет

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

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

.

Строка


Да

Имя файла

Нет

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

Строка

Нет

Путь к папке

Нет

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

Путь к папке

Нет

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

Нет

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

Логический

Нет

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

Результаты

Результат

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

.

Путь к файлу



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

...

  1. Если в параметрах диапазона указаны несуществующие страницы, то действие удалит страницы с первой указанной и по последнюю страницу из документа. Пример 
    Пример: В документе 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. Если пользователь укажет имя файла, но не укажет путь к папке, то файл будет сохранен с указанным именем в исходной папке.
  7. Если пользователь укажет путь к папке, но не укажет имя файла, то в указанной папке будет сохранен файл с исходным названием.
  8. Пользователь может переписать файл: если значение параметра перезаписи «true», и в указанной папке существует файл с таким же именем и расширением, то новый файл его перезапишет. Если «false», файл перезаписан не будет и действие бросит ошибку. Тип исключения: Robin.Exception.FileAlreadyExists. Описание ошибки: "PDF-документ с указанным именем уже существует.".
  9. Результатом действия будет путь к PDF-документу с удаленными страницами. Исходный документ действие не меняет, а создает на его основе копию, содержащую изменения.

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

Задача

Решение

...

  1.  

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

Задача

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

Решение

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

Реализация

  1. Собрать следующую схему робота, состоящую из следующих действий.
    Image Added
  2. Настроить параметры для действия "Открыть".
    Image Added
  3. Настроить параметры для действия "Удалить страницы".
    Image Added
  4. Запустить робота, нажав на кнопку "Старт" в верхней панели. 

Результат

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