Прочитать таблицу

Eng: Read Table

Элемент предназначен для чтения данных из табличного элемента управления. Для корректной работы следует помещать его в контейнер Открыть браузер или Присоединиться к браузеру.

Если нажать на панели элемента кнопку Мастер, то откроется мастер чтения таблиц.

Read Table 2

В окне мастера выберите кнопку Захват.

Welcome Window

После чего выделите в браузере элемент, который следует считать строкой таблицы.

Capture Element

Появится стандартное окно для формирования шаблона поиска (селектора). Установите необходимые свойства для идентификации элемента управления и нажмите ОК.

Search Template

В результате отобразится окно для формирования ячеек строки. Отметьте галочками группы данных и атрибуты, которые вы хотите считывать в качестве ячеек. Вы также можете указать имена для колонок таблицы (в столбце Имя колонки) и скорректировать CSS-селекторы данных или создать новые CSS-селекторы.

В завершение нажмите кнопку Проверить, чтобы просмотреть окно с результатами.

Cell Configuration

Пример результата:

Resulting Data

Свойства

Символ * указывает на обязательность заполнения. Описание общих свойств см. в разделе Свойства элемента.

Группа «Процесс»:

1. Тэг строки* [String] — тег элемента строки.

2. Тэг колонки* [String] — тег элемента колонки.

3. Тэг заголовка [String] — тег элемента заголовка.

4. Мастер [String] — шаблон для поиска элемента управления (то же, что и селектор), полученный через Мастер.

5. Шаблон поиска [String] — шаблон поиска элемента управления.

6. Элемент [LTools.WebBrowser.Model.IElementInfo] — переменная со ссылкой на элемент управления. Такую переменную можно получить при помощи компонента Присутствие элемента, а потом указать ее в этом свойстве. Для этого откройте редактор кода и укажите <название переменной>.BrowserElement. Пример:

   
7. Таймаут* [Int32] — предельное время ожидания завершения процесса (в миллисекундах). По умолчанию 10000.

Группа «Вывод»:

1. Переменная LTools.WebBrowser.Model.WebDataTable] — переменная для хранения результатов чтения таблицы.

2. Переменная (таблица) [DataTable] — переменная для хранения результатов чтения таблицы в формате System.Data.DataTable.

Пример использования

Скачайте на Learning обучающий проект StudioActivities, чтобы просмотреть готовый RPA-процесс по работе с элементом Прочитать таблицу. Процесс находится по пути StudioActivities > Ru > Браузер > Прочитать таблицу.ltw. Откройте проект в Студии и запустите процесс.

Только код

Пример использования элемента в процессе с типом Только код (Pure code):

C#

LTools.WebBrowser.BrowserApp app = LTools.WebBrowser.BrowserApp.Init(wf, "Free email*", LTools.WebBrowser.Model.BrowserTypes_Short.IE);
//Шаблон поиска
LTools.WebBrowser.Model.WebDataTable tbl = app.ReadDataGrid("{\"Tag\":\"DIV\",\"SearchFrames\":false,\"Attributes\":[{\"Key\":\"CLASS\",\"Value\":\"header-bar\"}]}", "A", "SPAN");
//Элемент
LTools.WebBrowser.Model.IElementInfo el = app.FindElement("{\"Tag\":\"DIV\",\"SearchFrames\":false,\"Attributes\":[{\"Key\":\"CLASS\",\"Value\":\"header-bar\"}]}");
tbl = app.ReadDataGrid(el, "A", "SPAN");		
foreach (var r in tbl.Data)
	foreach (var c in r)
		LTools.Workflow.PrimoApp.AddToLog(wf, c);	

Python

app = LTools.WebBrowser.BrowserApp.Init(wf, "Free email*", LTools.WebBrowser.Model.BrowserTypes_Short.IE)
#Шаблон поиска
tbl = app.ReadDataGrid("{\"Tag\":\"DIV\",\"SearchFrames\":false,\"Attributes\":[{\"Key\":\"CLASS\",\"Value\":\"header-bar\"}]}", "A", "SPAN")
#Элемент
el = app.FindElement("{\"Tag\":\"DIV\",\"SearchFrames\":false,\"Attributes\":[{\"Key\":\"CLASS\",\"Value\":\"header-bar\"}]}")
tbl = app.ReadDataGrid(el, "A", "SPAN")
for r in tbl.Data:
	for c in r:
		LTools.Workflow.PrimoApp.AddToLog(wf, c)

JavaScript

var app = _lib.LTools.WebBrowser.BrowserApp.Init(wf, "Free email*", _lib.LTools.WebBrowser.Model.BrowserTypes_Short.IE);
//Шаблон поиска
var tbl = app.ReadDataGrid("{\"Tag\":\"DIV\",\"SearchFrames\":false,\"Attributes\":[{\"Key\":\"CLASS\",\"Value\":\"header-bar\"}]}", "A", "SPAN");
//Элемент
var el = app.FindElement("{\"Tag\":\"DIV\",\"SearchFrames\":false,\"Attributes\":[{\"Key\":\"CLASS\",\"Value\":\"header-bar\"}]}");
tbl = app.ReadDataGrid(el, "A", "SPAN");	
for (var i = 0; i < tbl.Data.Count; i++)
	for (var j = 0; j < tbl.Data[i].Count; j++)
		_lib.LTools.Workflow.PrimoApp.AddToLog(wf, tbl.Data[i][j]);