Skip to Content
Элементы в StudioВстроенные для WindowsБраузерПрочитать таблицу

Eng: Read table

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

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

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

Read Table 2

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

Welcome Window

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

Capture Element

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

Search Template

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

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

Cell Configuration

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

Resulting Data

Свойства

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

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

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

  2. Область [System.Drawing.Rectangle] — обозначение области поиска компонента.

  3. Тэг строки* [String] — тег элемента строки. Например “TH”.

  4. Тэг колонки* [String] — тег элемента колонки. Например “MY”.

  5. Тэг заголовка [String] — тег элемента заголовка. Например “TO”.

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

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

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

    alt

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

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

Новый мастер чтения таблиц

С версии 1.25.1 улучшен инструмент Мастер чтения таблиц. Этот инструмент позволяет эффективно настраивать, извлекать и обрабатывать данные из веб-таблиц. Окно “Парсинг данных” отображает информацию о количестве извлечённых строк и столбцов. Если данные не найдены, отображается 0 строк, 0 столбцов.

Содержит следующие элементы:

  • Кнопка “Подтвердить”: Завершает процесс извлечения с текущими настройками.
  • Кнопка “Настройки” (иконка шестерёнки)

Дополнительные параметры настройки:

  • Сохранить в переменную — позволяет сохранить извлечённые данные в указанную переменную.
  • Ограничить извлечение — устанавливает ограничения на количество строк и столбцов.
  • Дополнительные параметры — позволяют задать специфические настройки для точного извлечения данных.

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

Как использовать мастер чтения таблиц

  1. В активности Прочитать таблицу нажмите на кнопку “Мастер”.
  2. Укажите место считывания данных на экране.
  3. Подтвердите процесс извлечения с текущими настройками.
  4. Дождитесь завершения прогресса парсинга.
  5. Проверьте предварительный результат в окне “Парсинг данных”.
  6. При необходимости откройте Настройки для уточнения параметров извлечения.
  7. Подтвердите процесс, нажав кнопку “Подтвердить”.
  8. Если требуется повторная настройка, воспользуйтесь опцией сброса параметров и начните процесс заново.

Если необходимо воспользоваться старым мастером чтения таблиц, то перейдите в Настройки Студии — Общие — Элементы — Установить чек бокс Использовать старый мастер чтения таблиц.

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

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

Только код

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

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);
Получить атрибутСкачать изображение