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

Старая версия 3

changes.mady.by.user lismaili@rpa-robin.ru

Сохранено

по сравнению с

Новая версия 4

changes.mady.by.user lismaili@rpa-robin.ru

Сохранено

Ключ

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

...

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

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

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


Иконка


Параметры

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

...


Название

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

Описание

Тип данных

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

Действие

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


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



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

Контекст

Да

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

Экземпляр PDF

Да

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

Да

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

Строка

Да

Имя файла

Нет

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

Строка

Нет

Путь к папке

Нет

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

Путь к папке

Нет

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

Нет

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

Логический

Нет

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

Результат


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

Путь к файлу


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

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


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

Задача

Имеется Excel-документ под названием "Test" с тремя вкладками Лист 1, Лист 2, Лист 3. Активная вкладка - Лист 1. Необходимо сделать активной вкладку Лист 3. 

Решение

Воспользоваться действиями "Открыть", "Активировать лист", "Сохранить". 

Реализация