ONDOWNLOAD — работа с загрузками

Команда ONDOWNLOAD iMacros

Команда ONDOWNLOAD iMacros автоматически обнаруживает и перехватывает загрузки. Используйте команду до начала загрузки, чтобы определить месторасположение и имя сохраняемого файла. Тайм-аут для страницы так же относится и к загрузкам. Убедитесь, что значение времени ожидания достаточное, чтобы файл успел загрузиться.

Обычно имя загружаемого файла создается автоматически на сервере. Вы можете добавить свои детали к исходному имени файла, используя знак «+» (смотрите примеры ниже). Встроенная переменная !NOW особо полезна в данном случае.

iMacros может посчитать контрольную сумму загруженного файла и сравнить ее со значением параметра CHECKSUM. Вы можете проверить что загруженные файлы не повреждены, или еще хуже, были заражены вирусом (через взломанный сервер). Поддерживаются MD5 и SHA1 контрольные суммы.

Работает в: iMacros Browser icon Internet Explorer icon Mozilla Firefox icon Google Chorme icon

Синтаксис:

или

Параметры:

  • FOLDER
    Указывает путь к папке, в которую будет сохранен файл. Используйте * для использования стандартной папки загрузки iMacros, которая указана в настройках.
    Обратите внимание, что пробелы в пути нужно заменить на <SP>: C:\Моя<SP>папка (вместо C:\Моя папка).
  • FILE
    Задает имя файла, под которым файл будет сохранен. Если расширения файла не задано, то используется значение по умолчанию. Используйте * чтобы оставить имя файла без изменений. Используйте + для того, чтобы добавить дополнительную информацию к исходному имени файла (перед расширением файла), зачастую добавляют временную метку !NOW.
  • WAIT
    Указывает, должен ли iMacros ждать завершения загрузки (WAIT=YES) или продолжить выполнять макрос без ожидания (WAIT=NO), по умолчанию YES.
  • CHECKSUM
    Вычисляет контрольную сумму загруженного файла и сравнивает ее с заданным значением (в виде шестнадцатеричной строки), используется либо MD5 или SHA-1 хэш-функции. Примечание: для работы CHECKSUM нужно WAIT=YES.
  • CANCEL iMacros Browser icon Internet Explorer icon
    Останавливает автоматическую загрузку с сайтов. Обратите внимание, что параметр CANCEL реализован в iMacros Browser v9.01 и выше.

Примеры:

Предположим, вы хотите скачать файл, который называется setup.exe. В следующем фрагмете кода ONDOWNLOAD iMacros сохранит этот файл под исходным именем в папку по умолчанию (задана в найстройках):

Этот пример сохранит файл в каталоге C:\МояПапка\ под названием myDownload.exe:

Еще один пример: команда будет сохранять файл в каталог по умолчанию, к названию файла будет добавлена отметка даты (с помощью переменной !NOW). Получится: setup_110217.exe.

Примечание: Символ «+» используется только если вы хотите добавить свой текст к исходному имени файла. В этом случае, «+» должен быть первым символом (FILE=+…). «+» нельзя использовать, если вы хотите объединить несколько переменных. Для того чтобы добавить значения переменных в название файла, просто вставьте их в строку. Пример:

Вы можете проверить целостность загруженного файла с помощью параметра CHECKSUM. При этом ожидаемая контрольная сумма ранее была рассчитана с помощью функции SHA-1.

В случае, когда вы хотите избежать автоматической загрузки (одного или нескольких) файлов, вы можете использовать параметр CANCEL (строка 1). CANCEL может быть задан только тогда, когда другие параметры в команда не используются. И действует до тех пор, пока не выполнится одна из команд в строке 3 или 4:

Скачиване PDF файлов:

Пожалуйста, убедитесь что вы отключили или удалите дополнения браузера для обработки PDF файлов, такие как Adobe. После этого браузер предложит вам скачать PDF как обычную загрузку, и теперь iMacros можнет автоматизировать это процесс.
ONDOWNLOAD iMacrosСайт для тестирования скачивания PDF файла:

Примечания:

  • После того, как происходит нажатие на скачиваемый файл, должно пройти немного времени перед тем как появится диалоговое окно для загрузки. Если iMacros не может словить это окно или останавливается с ошибкой, в этом случае рекомендую добавить небольшую временную задерку:

    после команды, которая запускает загрузку. Это дает iMacros время ожидания диалогового окна.
    Параметр WAIT=YES относится к другому ожидания, а именно после того, как загрузка началась он должен ждать ее завершения.
  • При работе с Internet Explorer вам необходимо включить автоматические запросы на загрузку, чтобы избежать появления уведомлений.
  • Необходимо включить показ расширений файлов (в проводнике Windows)! Иначе, ONDOWNLOAD iMacros не сможет переименовать файл, при загрузке, на ваш вариант. Либо используйте * для того чтобы сохранить файл как есть.
  • FOLDER не поддерживает относительный путь, а FILE поддерживает. В случае, если вы хотите загрузить файл в подпапку в стандартной папке iMacros Downloads, вы можете использовать параметр FILE, но вложенная папка должна существовать до начала загрузки файла.
  • Параметр FOLDER может создавать папки, так что, если вы хотите сохранить файл в папку которой еще нет, она должна быть вписана в FOLDER, а не в FILE.

Важные заметки:

  • Максимально допустимое время загрузки устанавливается !TIMEOUT_PAGE (60 сек по умолчанию). Так как оно рассматривается как и максимальное время загрузки, то если вам надо больше времени для загрузки файлов, пожалуйста, увеличьте это значение, например SET !TIMEOUT_PAGE 300. Если загрузка закончится раньше 5 мин (300 сек) макрос продолжит выполняться. В противном случае вы получите ошибку тайм-аута.
  • Если загрузка не началась до конца макроса, тогда ONDOWNLOAD iMacros будет ждать дополнительные !TIMEOUT_STEP секунд до остановки с ошибкой -1410: Загрузки не обнаружены.

Оставить комментарий

Ваш e-mail не будет опубликован. Обязательные поля помечены *