Ждать окончания загрузки файла/Wait for the file to finish downloading
Группа действий: Браузеры
Действие скачивает файл со страницы браузера и ожидает окончания его полной загрузки.
Настройки
| Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
|---|
| Параметры |
| Контекст | Context | Контекст действия для работы с браузером | Идентификатор сеанса браузера | ACTION_CONTEXT
| Да |
| Элемент | Element | Элемент, с которым работает действие. На странице в браузере этот элемент должен содержать URL, по которому можно скачать файл | Web-элемент |
| Да |
| Имя файла | File name | Наименование, которое будет иметь скачанный файл. Указанное наименование может не совпадать с исходным наименованием файла на сайте. | Строка |
| Да |
| Формат | Format | Формат, с которым будет скачан файл. Если указанное значение не совпадает с исходным форматом файла на сайте, открытие файла может сопровождаться ошибкой | Строка |
| Да |
| Путь к папке | Folder path | Путь к папке, в которой будет сохранен файл. | Путь к папке |
| Да |
| Тайм-аут | Time-out | Время ожидания ответа от ресурса, с которого будет скачан файл. Если время ожидания ответа превысит указанное значение, действие вернет ошибку. Задается в миллисекундах. Значение по умолчанию: 10000 мс | Число | 10 | Нет |
| Результаты |
| Результат | Result | Путь к скачанному файлу | Путь к файлу |
|
|
Особые условия использования
- Основной принцип работы действия: с помощью селениума действие будет находить указанный веб-элемент на странице и извлекать из него URL файла. Скачивать файл действие будет по URL уже через джаву, а не браузер. Пока файл не скачается, действие не закончит свою работу, т.е. робот будет ждать завершения сохранения файла.
- Если действие не нашло указанный элемент, действие возвращает ошибку.
- Если указанный элемент найден, но не содержит URL для скачивания файла, действие возвращает ошибку.
- Можно указывать любое имя для скачиваемого файла, даже если оно не совпадает с тем, которое изначально имеет файл - с таким наименованием файл и будет сохранен.
- Расширение файла указывается отдельно. Пример заполнения: .png, .xlsx и т.п. Действие не проверяет исходный формат файла, просто сохраняет файл в том формате, который указал пользователь в параметрах.
- Файл должен скачиваться в ту папку, которая указана в параметрах. Результат действия - полный путь к скачанному файлу.
- Если полный путь к файлу превышает допустимый в лимит системы на кол-во знаков в пути, действие сразу возвращает ошибку, не начиная скачивать файл.
- Если URL, указанный в веб-элементе, неверный, ведет на какую-то другую страницу, нет ответа от сервера, т.е. скачивание файл не начинается, действие возвращает ошибку.
- Если время ожидания ответа от ресурса превысит значение, указанное в поле тайм-аута, действие возвращает ошибку. Для пользователя в параметрах это одно поле тайм-аута, но в действии должна быть 2 ожидания: одно используется при установлении соединения по URL - ошибка будет, если не было установлено соединение в течение указанного времени; другое используется, когда уже началось скачивание, но данные перестали поступать - в этот момент начинается отсчет времени ожидания; ошибка будет, если данные не продолжат поступать в течение указанного времени.
Пример использования
Задача:
Решение:
Реализация:
Результат: