Переменные в парсере

Надстройка «Парсер сайтов» позволяет использовать переменные для временного сохранения значений, с целью использования этих значений в других настройках / действиях программы.

Переменная имеет имя и значение. Указывая имя переменной, мы можем записать в неё произвольное значение, либо считать ранее сохранённое значение.

Использование переменных сильно упрощает настройку сложных парсеров, позволяя более гибко манипулировать данными при обработке.

Область видимости переменных

Доступны 2 варианта: parser (применимы в любом разделе настроек / в любом действии парсера), и row (применимы только внутри одной выводимой / обрабатываемой строки)
Область видимости row практически не используется, оставлена в целях совместимости с прежними версиями
(всегда используйте только облась видимости parser, если есть возможность выбора)
 

Время жизни переменных (с момента записи значения в переменную)

для переменных уровня row - с момента начала вывода строки на лист, до перехода к выводу другой строки
для переменных уровня parser - до завершения работы парсера
 

Требования к имени переменной

Имя переменной не должно содержать в имени следующие символы:

• * (звёздочка)
• % (процент)
• ? (знак вопроса)
• # (решётка)
• ! (восклицательный знак)

Любые другие символы использовать можно (русские и английские буквы, пробелы, и вообще что угодно)

Подстановочные символы (*, ?, #) могут использоваться в действии «Очистить значение переменной» для очистки сразу нескольких переменных, поэтому для переменных, содержащих эти символы в названии, очистка переменных работать не будет (в остальном - проблем нет, т.е. эти символы использовать можно, просто нежелательно)

Символ % используется для обращения к переменной из параметров действий (запись вида %VarName%), поэтому его использование в имени переменной недопустимо.

Символ ! (восклицательный знак), начиная с версии программы 3.7.0 (май 2020 года), используется для переменных-словарей, когда в одной переменной сохранено несколько именованных значений (переменная имеет не текстовый тип, как «обычные» переменные, а тип Dictionary)
 

Доступ к переменным

Сохранение данных в переменные производится 4 способами:

• специальным действием Сохранить текущее значение в переменную
• указанием имени переменной в специальном параметре некоторых действий (например, таких как Задать новое значение, Поиск тегов, и др.)
• автоматическое сохранение парсером значений в специализированные переменные
• прописыванием значений переменных до запуска парсера в файле parser.ini

Обращение к переменным в настройках производится 2 способами:

• специальным действием Считать значение переменной
• указанием имени переменной в любом параметре любых действий, в виде %ИмяПеременной%
  (добавляем символы % до и после названия переменной, чтобы программа поняла, что этот текст надо заменить значением переменной)
   

Типы переменных

По умолчанию, все переменные имеют общий / текстовый тип.
В такую переменную сохраняются любые данные, используемые парсеров (текст, HTML, числа, массивы значений).
Что записали в переменную, то потом из неё и считали.

Начиная с версии программы 3.7.0 (май 2020 года), поддерживается новый тип переменных: переменные-словари (тип Dictionary, - для тех, кто знаком с языком программирования VBA).
Dictionary — это словарь, позволяющий хранить пары вида Название - Значение (именованный массив). Названия (имена элементов внутри словаря) должны быть уникальными, — в словаре не может быть несколько отдельных записей с одинаковым названием.

Названия таких переменных-словарей имеют вид DicName! (название переменной завершается символом !), а обращение к отдельным записям (именованным элементам словаря) производится с использованием синтаксиса DicName!VarName (название переменной-словаря, потом восклицательный знак, потом имя элемента в словаре).

Более подробная инструкция с примерами использования переменных-словарей будет доступна позднее.