Переменная iMacros !COLn

Переменная !COL(n - обязательное значение) служит для указания стобца в строке получаемой из источника данных. Переменная !COL1 указывает на выбор первого столбца в строке данных.. Меняйте 1 на любое другое число, в зависимости от того, какой столбец вам надо вытащить из строки. Даже если вы не знаете сколько столбцов определено в строке файла данных, а отдельные данные находятся на разных строках, то обязательно нужно использовать переменную !COL1.

Частный случай использования переменную !COL1 - получение данных, которые в файле-источнике сохранены в кавычках. ( Запись "Demo" переменная !COL1 перередаст в макрос , как Demo )

Работает в:  

Вместо n может быть использовано любое целое, положительное число больше 0 и меньше !DATASOURCE_COLUMNS (количество колонок в строке файла-источника).

Задается:

× Внутренняя переменная
✓ Командой SET
«Внутренняя переменная» означает, что сам iMacros устанавливает значение данной переменной во время выполнения макроса. SET означает, что пользователь может установить это значение с помощью команды SET при редактировании макроса.

Пример:

В примере файл example.csv содержит «Имя» в первом (извлекается при помощи переменной !COL1 iMacros) и «Фамилию» во втором (!COL2) столбце. На сайт мы хотим вставить эти значения в соответствующие поля.

SET !DATASOURCE example.csv
SET !DATASOURCE_LINE {{!LOOP}}
URL GOTO=http://www.some_input.com/enter_name.html
TAG POS=1 TYPE=INPUT:TEXT FORM=form1 ATTR=NAME:first_name CONTENT={{!COL1}}
TAG POS=1 TYPE=INPUT:TEXT FORM=form1 ATTR=NAME:last_name CONTENT={{!COL2}}

Переменная iMacros !DATASOURCE

Переменная !DATASOURCE iMacros задает имя и расположение файла, данные из которого служат источником для макроса. Если папка не указана, тогда предполагается, что файл находится в стандартном каталоге iMacros, обычно это: %Имя_пользователя%\Documents\iMacros\Datasources\. В качестве значения, которое принимает команда, является существующее имя и путь исходного файла.

iMacros умеет читать данные  не только из текстовых файлов, в формате .csv и .txt, но и  текстовых файлов, со столбцами данных, сохраненных с расширением json.( результат работы пользовательских js ).

Работает в:

Задается:

× Внутренняя переменная
✓ Командой SET
«Внутренняя переменная» означает, что сам iMacros устанавливает значение данной переменной во время выполнения макроса. SET означает, что пользователь может установить это значение с помощью команды SET при редактировании макроса.

Примеры с !DATASOURCE iMacros:

Самый простой пример использования переменной !DATASOURCE вместе с командой SET:

SET !DATASOURCE C:\мойфайл.txt

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

SET !DATASOURCE "C:\\Моя iMacros папка\\мойфайл.txt"

В качестве альтернативы предыдущему способу, можно все пробелы в пути заменить на <SP>, тогда не нужно использовать двойные кавычки, и дублирование обратных слешей:

SET !DATASOURCE C:\Моя<SP>iMacros<SP>папка\мойфайл.txt

Так же можете посмотреть пример макроса: Demo-Datasource.iim

Примечания:

• Дополнение iMacros для Internet Explorer и iMacros Browser могут использовать не только запятую в качестве разделителя в CSV файле, либо разделитель списков, который задан в Windows Regional Settings (региональные настройки). Если хотите изменить разделитель для чтения и записи (так же и для команды SAVEAS TYPE=EXTRACT), установите флажок в диалоговом окне параметров iMacros (iMacros Options).
• iMacros для Firefox использует запятую в качестве разделителя по умолчанию. Чтобы указать другой разделитель, используйте !DATASOURCE_DELIMITER (смотрите ниже).
• По состоянию на май 2016 года у iMacros для Chrome наблюдаются проблемы с доступом к файлам на компьютере пользователя.

!DATASOURCE COLUMNS

Переменная !DATASOURCE_COLUMNS iMacros задает количество столбцов в файле, из которого считывается информация. В качестве значения принимает положительное целое число. Работа с колонками подробнее описана в статье !COLn .

Примечание:

• Задание данной переменной обязательно только в iMacros для Chrome, во всех других версиях автоматически определяется количество столбцов.

Работает в:

Задается:

× Внутренняя переменная
✓ Командой SET

Пример:

SET !DATASOURCE_COLUMNS 3

!DATASOURCE DELIMITER

Переменная !DATASOURCE_DELIMITER iMacros позволяет переопределить символ, используемый для разграничения данных (столбцов) в вашем входном файле CSV или TXT. Значением по умолчанию является запятая (,), но можно встретить знаки: точка (.), точка с запятой (;), знак доллара ($) или процента (%).

Работает в:  

Задается:

× Внутренняя переменная
✓ Командой SET

Примечания:

• Тип разделителя должен быть указан перед заданием значения для !DATASOURCE.
• Данная переменная относится только к iMacros for Firefox. Для изменения разделителя в iMacros для IE или iMacros браузере смотрите примечания к !DATASOURCE iMacros (в начале статьи).

Пример:

SET !DATASOURCE_DELIMITER ;
SET !DATASOURCE C:\мойфайл.txt

!DATASOURCE LINE

Переменная !DATASOURCE_LINE iMacros определяет строку в файле с данными, которая используется для получения информации. В качестве значения допускается положительное целое число.

Работает в:

Задается:

× Внутренняя переменная
✓ Командой SET

Пример:

Код ниже показывает как можно при помощи переменной !LOOP изменять строку для считывания данных из !DATASOURCE , при запуске через цикл:

SET !DATASOURCE_LINE {{!LOOP}}

Группа переменных DOWNLOADED iMacros используется для работы со скачиваемыми файлами. Можно определять имя и место загружаемого файла, для этого используется переменная !DOWNLOADED_FILE_NAME. А при помощи !DOWNLOADED_SIZE в iMacros можно определить размер скачиваемого файла, который записывается в байтах. Подробнее про каждую переменную читайте ниже.

!DOWNLOADED_FILE_NAME

Переменная содержит каталог и имя загруженного файла. Следует использовать в тот момент, когда загрузка завершена. Для этого используйте переменную после команды, которая запускает загрузку, и убедитесь, что значение тайм-аута загрузки (!TIMEOUT_DOWNLOAD) достаточно длинное, чтобы покрыть полное время загрузки. Параметр WAIT в команде ONDOWNLOAD должен быть установлен в YES (WAIT = YES).

Работает в:  

Задается:

× Внутренняя переменная
✓ Командой SET
«Внутренняя переменная» означает, что сам iMacros устанавливает значение данной переменной во время выполнения макроса. SET означает, что пользователь может установить это значение с помощью команды SET при редактировании макроса.

Примеры:

Скопируйте место загрузки и имя файла во встроенную переменную !EXTRACT:

ADD !EXTRACT {{!DOWNLOADED_FILE_NAME}}

Отображение содержимого встроенной переменной:

ONDOWNLOAD FOLDER=* FILE=* WAIT=YES
TAG POS=3 TYPE=A ATTR=TXT:Скачать 
PROMPT {{!DOWNLOADED_FILE_NAME}}

!DOWNLOADED_SIZE

Содержит размер в байтах загруженного файла. Переменную следует использовать в тот момент, когда загрузка завершена. Для этого используйте переменную после команды, которая запускает загрузку, и убедитесь, что значение тайм-аута загрузки (!TIMEOUT_DOWNLOAD) достаточно длинное, чтобы покрыть полное время загрузки. Параметр WAIT в команде ONDOWNLOAD должен быть установлен в YES (WAIT = YES).

Работает в:

Задается:

× Внутренняя переменная
✓ Командой SET
«Внутренняя переменная» означает, что сам iMacros устанавливает значение данной переменной во время выполнения макроса. SET означает, что пользователь может установить это значение с помощью команды SET при редактировании макроса.

Примеры:

Скопируйте загруженный размер файла в байтах в встроенную переменную !EXTRACT:

ADD !EXTRACT {{!DOWNLOADED_SIZE}}

Отображение содержимого встроенной переменной:

ONDOWNLOAD FOLDER=* FILE=* WAIT=YES
TAG POS=3 TYPE=A ATTR=TXT:Скачать 
PROMPT {{!DOWNLOADED_SIZE}}

Переменная iMacros !ENCRYPTION

Переменная !ENCRYPTION задает способ шифрования паролей, которые используются в макросах. Применяется только к значениям полей с типом = пароль (password). Поле пароля — это те поля, где слова отображаются с помощью звездочек (*). Установка этой переменной в макросе перезапишет настройки на вкладке Параметры (Options) -> Безопасность (Security tab).

1. Без шифрованияПароль хранится внутри макроса в виде обычного текста. Чтобы активировать эту опцию, установите (при помощи SET) для !ENCRYPTION значение NO.
2. Зашифрованные пароли веб-сайтовПароли шифруются с помощью мастер-пароля (мастер-ключа), который хранится на вашем компьютере. Для того чтобы активировать эту опцию, установите !ENCRYPTION в STOREDKEY.
3. Зашифрованные пароли веб-сайтов и запрос мастер-пароля
   Главный пароль (мастер-пароль) не хранится на компьютере, он только временно хранится в оперативной памяти, пока работает макрос. Если вы хотите активировать эту опцию, установите !ENCRYPTION в TMPKEY.

Примечания:

• Что такое мастер-пароль или главный пароль? Это один пароль (строка символов) которую вам надо запомнить или которая хранится в виде файла на компьютере. При помощи данной строки, пароли, используемые в макросах шифруются, и в защифрованном виде записываются в макрос. Т.е. даже если вы случайно отправите другу макрос с конфиденциальными данными (которые зашифрованы при помощи !ENCRYPTION iMacros), то он ничего не сможет с ними сделать, поскольку он не знает мастер-пароль для расшифровки данных. Поэтому ваши пароли находятся в безопасности.
• В настоящее время шифрование паролей не поддерживается командами DirectScreen или IMAGECLICK.

Cинтаксис:

SET !ENCRYPTION NO|STOREDKEY|TMPKEY

Работает в:

Задается:

× Внутренняя переменная
✓ Командой SET
«Внутренняя переменная» означает, что сам iMacros устанавливает значение данной переменной во время выполнения макроса. SET означает, что пользователь может установить это значение с помощью команды SET при редактировании макроса.

Примеры:

Если вы хотите разблокировать пароли с использованием мастера-пароля:

SET !ENCRYPTION TMPKEY

Или же хотите вручную ввести все пароли (записаны в маросе в незашифрованном виде), используйте:

SET !ENCRYPTION NO

Переменная iMacros !EXTRACT

Переменная !EXTRACT cодержит результаты извлечения информаци, полученный при помощи TAG + EXTRACT.

Если в одном макросе используется несколько раз команда EXTRACT,  результаты отделяются друг от друга строкой «[EXTRACT]». Данная строка автоматически заменяется на запятую во время сохранеия (SAVEAS TYPE=EXTRACT).

Если извлекается таблица целиком, то соседние элементы таблицы отделяются друг от друга строкой «#NEXT#», а строки таблицы разделяются строкой «#NEWLINE#». Эти теги автоматически заменяются запятой и переводом строки при использовании команды SAVEAS.

Содержит результат извлечения или «#EANF#» (если неудалось найти элемент).

Работает в:

Задается:

✓ Внутренняя переменная
✓ Командой SET
✓ Командой ADD
× Внутренняя переменная
✓ Командой SET
«Внутренняя переменная» означает, что сам iMacros устанавливает значение данной переменной во время выполнения макроса. SET означает, что пользователь может установить это значение с помощью команды SET при редактировании макроса. ADD означает, что к существующей переменной можно добавить дополнительное значение.

Примеры:

Заполняет значением переменной !EXTRACT полей формы:

TAG .... CONTENT={{!EXTRACT}}

Скопировать извлеченные данные в буфер обмена:

SET !CLIPBOARD {{!EXTRACT}}

Сбросить / обнулить содержимое переменной:

SET !EXTRACT NULL

Добавить значение первого столбца CSV файла к уже полученному результату:

ADD !EXTRACT {{!COL1}}

Переменная iMacros !NOW

Переменная !NOW cодержит текущее время и дату. Используется для формирования даты, времени. Во время формировании переменной вы можете использовать форматы указанные ниже, написанные через двоеточие (:).

Работает в:

Синтаксис:

!NOW:формат_записи

Формат записи:

Код формата чувствителен к регистру. Формат может содержать пробелы, но убедитесь, что вы используете сочетание вместо пробела.

• Ничего
  Если использовать команду !NOW iMacros без указания формата вывода, то по умолчанию отображается сочетание системной даты и времени в формате, определенном общепринятым стандартом (ISO 8601).
• dd
  Отображает день в виде 2-значного числа (01 — 31)
• mm
  Указывает месяц в виде 2-значного числа (01 — 12).
• yy
  Показывает год как 2-значное число (00 — 99).
• yyyy
  Отображает год в виде 4-значного числа (1000 — 9666).
• hh
  Отображает час в виде 2-значного числа (00 — 23).
• nn
  Показывает минуты, как 2-значное число (00 — 59).
• ss
  Отображает секунды как 2-значное число (00 — 59).
• Любые другие символы
  Используются только как разделители.

Примечание:

• iMacros для Firefox и iMacros для Chrome не поддерживают !NOW без указания формата вывода!

Задается:

× Внутренняя переменная
✓ Командой SET
«Внутренняя переменная» означает, что сам iMacros устанавливает значение данной переменной во время выполнения макроса. SET означает, что пользователь может установить это значение с помощью команды SET при редактировании макроса.

Примеры:

В примерах ниже предполагается что переменая !NOW iMacros содержит дату 25-го мая 1980 года, 4:35:00 утра:

!NOW:ddmmyy_hhnnss

Результат: 25051980_043500

!NOW:yyyy-mm-dd hhч nnмин

Результат: 1980-05-25 04ч 35мин

Замечу, использование переменных в iMacros всегда требует двойных фигурных скобок. Вот полный пример использование переменной NOW в макросе:

VERSION BUILD=7361445
TAB T=1
TAB CLOSEALLOTHERS
URL GOTO=http://www.amazon.com/
TAG POS=1 TYPE=INPUT:TEXT FORM=NAME:site-search ATTR=ID:twotabsearchtextbox CONTENT="{{!NOW:yyyy/mm/dd_hhnn}} пример"