convert_number(number, object_name, frame=-1); - преобразовать номер элемента в номер заданного объекта (например в номер для anchor,image ... )
number – номер по которому мы находим необходимый нам элемент на странице (int) . Номера элементов начинаются с 0 и для элементов разного типа своя нумерация. Чтобы узнать номер элемента, можно воспользоваться либо инспектором элементов, либо контекстным меню, либо посмотреть его в списке элементов.
object_name – имя объекта (типа элемента) в последовательности которого мы получаем номер (anchor,image,textarea и т.п.) frame – номер фрейма, в котором мы ищем элемент (string). Номера фреймов начинаются с нуля. По умолчанию -1 - элемент находится не во фрейме. Номер фрейма в котором находится нужный вам элемент можно узнать из инспектора задач, контекстного меню и панели списка элементов.
С версии 4.6.41 доступно: можно передавать вложенные фреймы, принцип такой же самый, передается строка с номерами фреймов, разделенных : например при передаче "1:0:5" - будет выбран фрейм с номером 1 в нем под фрейм с номером 0 и в нем подфрейм с номером 5
С версии 7.0.38 доступно: можно передавать "url=>XXX", тогда будет произведен поиск фрейма, который содержит заданный src, или передавать "name=>XXX" - тогда будет поиск фрейма, по заданной части имени.
После отработки функция возвращает результат своей работы в робот :
номер в заданной последовательности типа элемента – преобразованный номер для заданного объекта -1 – преобразование не удалось
Пример использования convert_number (PHP):
<?php $xhe_host = "127.0.0.1:7094"; // подключим объект для управления эмулятором, если еще не подключен if (!isset($path)) $path="../../../Templates/init.php"; require($path); // начало echo "<hr><font color=blue>element->".basename (__FILE__)."</font><hr>"; // 1 echo "1. Перейдем на полигон : "; echo $browser->navigate("http://rbot.biz-apps.ru/poligon/anchor.html")."<br>"; // 2 echo "2. Получим номера элемента с заданным текстом и его же как ссылки : "; $num_in_element=$element->get_number_by_inner_text("ссылка onmouseup"); $num_in_anchor=$element->convert_number($num_in_element,"anchor"); echo ($num_in_element." -> ".$num_in_anchor)."\n"; // 3 echo "3. Получим номера элемента с заданным текстом и его же как картинки : "; $num_in_element=$element->get_number_by_inner_text("ссылка onmouseup"); $num_in_anchor=$element->convert_number($num_in_element,"image"); echo ($num_in_element." -> ".$num_in_anchor)."\n"; // 4 echo "4. Получим номера несуществующего элемента и его же как картинки : "; $num_in_element=$element->get_number_by_inner_text("ptych"); $num_in_anchor=$element->convert_number($num_in_element,"image"); echo ($num_in_element." -> ".$num_in_anchor)."\n"; // 5 echo "5. Получим номера элемента с заданным текстом и его же как ссылки в нулевом фрейме : "; $num_in_element=$element->get_number_by_inner_text("ссылка onmouseup",0); $num_in_anchor=$element->convert_number($num_in_element,"anchor",0); echo ($num_in_element." -> ".$num_in_anchor)."\n"; // конец echo "<hr><br>"; // Quit $app->quit(); ?>
Пример использования convert_number (C#):
#region using using System; using System.Diagnostics; using System.Collections.Generic; using System.Linq; using System.IO; using System.Text; using System.Threading; using XHE; using XHE.XHE_DOM; using XHE.XHE_System; using XHE.XHE_Window; using XHE.XHE_Web; #endregion class Program:XHEScript { static void Main(string[] args) { // init XHE server="127.0.0.1:7010"; InitXHE(); // начало echo("<hr><font color=blue>element.get_tag_by_number</font><hr>"); // 1 шаг echo("1. Перейдем на полигон : "); echo(browser.navigate("www.rbot.biz-apps.ru/poligon/anchor.html")+"<br>"); // 2 шаг echo("2. Получим номера элемента с заданным текстом и его же как ссылки : "); int num_in_element=element.get_number_by_inner_text("ссылка onmouseup"); int num_in_anchor=element.convert_number(num_in_element,"anchor"); echo(num_in_element.ToString()+" -> "+num_in_anchor.ToString()+"\n"); // 3 шаг echo("3. Получим номера элемента с заданным текстом и его же как картинки : "); num_in_element=element.get_number_by_inner_text("ссылка onmouseup"); num_in_anchor=element.convert_number(num_in_element,"image"); echo(num_in_element.ToString()+" -> "+num_in_anchor.ToString()+"\n"); // 3 шаг echo("3. Получим номера несуществующего элементаи его же как ссылки : "); num_in_element=element.get_number_by_inner_text("ссылка onmouseup1"); num_in_anchor=element.convert_number(num_in_element,"anchor"); echo(num_in_element.ToString()+" -> "+num_in_anchor.ToString()+"\n"); // 4 шаг echo("4. Получим номера элемента с заданным текстом и его же как ссылки в 0 фрейме : "); num_in_element=element.get_number_by_inner_text("ссылка onmouseup",false,"0"); num_in_anchor=element.convert_number(num_in_element,"anchor","0"); echo(num_in_element.ToString()+" -> "+num_in_anchor.ToString()+"\n"); // конец echo("<hr><br>"); app.quit(); } }
Пример использования convert_number (Python):
# Additional paths import sys sys.path.insert(0, '../../../Templates PY/') xhe_host = "127.0.0.1:7010" from xweb_human_emulator import * # начало echo("<hr><font color=blue>element.xxxxxxxxx</font><hr>") # 1 echo("1. Перейдем на полигон : ") echo(browser.navigate("http://www.rbot.biz-apps.ru/poligon/anchor.html"),"<br>") # 2 echo("2. Получим номера элемента с заданным текстом и его же как ссылки : ") num_in_element=element.get_number_by_inner_text("ссылка onmouseup") num_in_anchor=element.convert_number(num_in_element,"anchor") echo(str(num_in_element)+" . "+str(num_in_anchor),"\n") # 3 echo("3. Получим номера элемента с заданным текстом и его же как картинки : ") num_in_element=element.get_number_by_inner_text("ссылка onmouseup") num_in_anchor=element.convert_number(num_in_element,"image") echo(str(num_in_element)+" . "+str(num_in_anchor),"\n") # 4 echo("4. Получим номера несуществующего элемента и его же как картинки : ") num_in_element=element.get_number_by_inner_text("ptych") num_in_anchor=element.convert_number(num_in_element,"image") echo(str(num_in_element)+" . "+str(num_in_anchor),"\n") # 5 echo("5. Получим номера элемента с заданным текстом и его же как ссылки в нулевом фрейме : ") num_in_element=element.get_number_by_inner_text("ссылка onmouseup",0) num_in_anchor=element.convert_number(num_in_element,"anchor",0) echo(str(num_in_element)+" . "+str(num_in_anchor),"\n") # конец echo("<hr><br>") # Quit app.quit()
Пример использования convert_number (JS):
// подключим объект для управления эмулятором, если еще не подключен xhe_host="127.0.0.1:7010"; echo=require("../../../Templates JS/init.js"); // начало echo("<hr><font color=blue>element.convert_number</font><hr>"); // 1 шаг echo("1. Перейдем на полигон : "); echo(browser.navigate("http://www.rbot.biz-apps.ru/poligon/anchor.html")+"<br>"); // 2 шаг echo("2. Получим номера элемента с заданным текстом и его же как ссылки : "); num_in_element=element.get_number_by_inner_text("ссылка onmouseup",true); num_in_anchor=element.convert_number(num_in_element,"anchor"); echo((num_in_element+" = "+num_in_anchor)+"\n"); // 3 шаг echo("3. Получим номера элемента с заданным текстом и его же как картинки : "); num_in_element=element.get_number_by_inner_text("ссылка onmouseup"); num_in_anchor=element.convert_number(num_in_element,"image"); echo((num_in_element+" = "+num_in_anchor)+"\n"); // 4 шаг echo("4. Получим номера несуществующего элемента и его же как картинки : "); num_in_element=element.get_number_by_inner_text("ptych"); num_in_anchor=element.convert_number(num_in_element,"image"); echo((num_in_element+" = "+num_in_anchor)+"\n"); // 5 шаг echo("5. Получим номера элемента с заданным текстом и его же как ссылки в нулевом фрейме : "); num_in_element=element.get_number_by_inner_text("ссылка onmouseup",0); num_in_anchor=element.convert_number(num_in_element,"anchor",0); echo((num_in_element+" = "+num_in_anchor)+"\n"); // конец echo("<hr><br>"); // Quit app.quit();