set_value_by_attribute_by_form_number(attr_name, attr_value, exactly, value, form_number, frame=-1); - данная функция используется для задания значения элементу страницы, находя его по значению заданного атрибута - в форме с заданным номером.
Функция на вход принимает параметры:
- attr_name – имя атрибута, значение которого мы будем искать (string). Чтобы узнать имена атрибутов у элемента, можно воспользоваться либо инспектором элементов, либо контекстным меню, либо посмотреть его в списке элементов.
- attr_value – значение атрибута, по которому мы будем искать элемент в заданной форме (string). Чтобы узнать значение заданного атрибута у элемента, можно воспользоваться либо инспектором элементов, либо контекстным меню, либо посмотреть его в списке элементов.
- exactly – точное соответствие значения заданного атрибута при поиске элемента (boolean), если true - значение заданного атрибута элемента должно полностью совпадать с переданным параметром ( attr_value), если этот параметр задан как false, то будет найден первый элемент, заданного типа в форме, где в значении заданного атрибута содержится заданная строка ( attr_value).
- value – значение, которое будет задано элементу (string).
- form_number – номер формы, в котором мы ищем элемент (int). Номера форм начинаются с нуля и в каждом фрейме своя нумерация форм. Номер формы в котором находится нужный вам элемент можно узнать из инспектора задач, контекстного меню и панели списка элементов.
- frame – номер фрейма, в котором мы ищем элемент (string). Номера фреймов начинаются с нуля. По умолчанию -1 - элемент находится не во фрейме. Номер фрейма в котором находится нужный вам элемент можно узнать из инспектора задач, контекстного меню и панели списка элементов.
С версии 4.6.41 доступно: можно передавать вложенные фреймы, принцип такой же самый, передается строка с номерами фреймов, разделенных : например при передаче "1:0:5" - будет выбран фрейм с номером 1 в нем под фрейм с номером 0 и в нем подфрейм с номером 5
С версии 7.0.38 доступно: можно передавать "url=>XXX", тогда будет произведен поиск фрейма, который содержит заданный src, или передавать "name=>XXX" - тогда будет поиск фрейма, по заданной части имени.
После отработки функция возвращает результат своей работы в робот (тип возвращаемого значения boolean):
- true – выполнили успешно
- false – найти такой элемент не удалось (например нет вообще элементов, удовлетворяющих заданным критериям или нет такого фрейма)