Получить табличные данные

Описание

Блок считывает табличные данные из UI-элемента десктопного приложения. Блок может вернуть всю таблицу, конкретную ячейку или размерность таблицы.

Примечание

Если требуется получить всю таблицу, в индексы строки и столбца можно передать Ничто.

Предупреждение

При считывании данных блок быстро перебирает таблицу и может автоматически прокручивать ее по горизонтальной и вертикальной осям. Это штатное поведение, которое необходимо учитывать при наблюдении за работой программного робота.

---

Описание параметров

Блок имеет несколько параметров:

1. Индекс строки - индекс строки таблицы для получения конкретного значения.

   Тип данных: int (Целое число) | None (Ничто)

   Пример: 4

2. Индекс столбца - индекс столбца таблицы для получения конкретного значения.

   Тип данных: int (Целое число) | None (Ничто)

   Пример: 2

3. Получить размерность таблицы - возвращает размерность таблицы вместо её содержимого.

   Тип данных: checkbox (Чекбокс)

   Пример: ✔

   Примечание

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

4. Использовать объект элемента - позволяет передать объект UI-элемента или JSON-строку.

   Тип данных: object (Объект элемента) | str (Строка)

   Пример: [{"ControlTypeName":"TableControl","Name":"Процессы"}]

   Подробнее про использование объекта UI-элемента Поиск элементов - Блок позволяет выполнить поиск UI-элементов десктопного приложения.
   

   JSON-строка указывается с помощью блока создать строку.

   

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

Master UI для десктопных приложений Мастер UI для работы с десктопными приложениями - встроенный инструмент Puzzle RPA, который позволяет извлекать свойства элементов десктопных приложений. Подробнее...

---

Возвращаемое значение

Тип данных: list (Список) | str (Строка) | DataFrame (Таблица)

Пример: [4996, 42] | "ячейка строки 10 столбца 10" | DataFrame

Блок возвращает содержимое таблицы, значение конкретной ячейки или размерность таблицы в зависимости от настроек.

---

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

В данном примере открывается Диспетчер задач и производится считывание табличных данных из него.

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

1. Открывается инструмент Master UI для десктопных приложений;

2. Выполняется выбор любого элемента таблицы;

   

   Заметка

   В данном примере выбран не весь UI-элемент таблицы (который необходим для работы блока), а лишь один из её внутренних элементов. Этот элемент является дочерним по отношению к родительскому элементу, представляющему всю таблицу.

   Дерево элементов приложения имеет вид:

   

   Поэтому для использования UI-элемента таблицы необходимо исключить конечный (вложенный) узел из выбранного элемента.

3. В инструменте Master UI, выполняется отключение последнего узла выбранного элемента.

   

---

Алгоритм состоит из блоков:

• Открыть приложение Диспетчер задач;
• Получить табличные данные;
• Уведомление пользователя с результатом.

---

Результат

Результат считывания таблицы:

---