Получить текст — документация 0.4

ui.getText · Windows

Читает текст элемента (значение поля, текст или имя)

Читает текст элемента в переменную: значение поля, надпись, текст документа. Так получают результат работы программы — номер документа, сумму, сообщение об ошибке, — чтобы проверить его или записать в отчёт.

Свойства #

Свойство	Имя в файле	Значение	Обязательное	По умолчанию	Описание
Селектор	`selector`	селектор Windows	да	—
Таймаут, мс	`timeoutMs`	число	нет	10000

Результат #

Значение выхода сохраняется в переменную, выбранную для него в свойствах шага (раздел выходов).

Выход	Имя в файле
Текст	`text`

Как работает #

Селектор (selector) — путь к элементу от окна приложения. Задаётся пикером: кнопка «Указать на экране», наведите курсор на элемент и нажмите Ctrl. Проверить, что селектор находит элемент, — «Подсветить»; поправить вручную — «Изменить». Подробнее — Пикер элементов.
Текст берётся по порядку: значение поля (ValuePattern), текст документа (TextPattern), иначе имя элемента — то, что видит пикер в подсказке.
Таймаут, мс (timeoutMs, по умолчанию 10000) — сколько ждать появления элемента; поиск повторяется каждые 200 мс. Если элемент нашёлся за 2 с и дольше, в лог пишется совет уточнить селектор.
Выход Текст — всегда строка; число получите выражением: Number(text.replace(',', '.')).

Ошибки #

Код	Причина и что делать
`ElementNotFound`	Элемент не найден за время ожидания: окно не открыто, свёрнуто под другим или интерфейс изменился. Проверьте селектор кнопкой «Подсветить», при необходимости укажите элемент заново

При ошибке робот сохраняет снимок экрана: в студии он открывается по ссылке «Открыть скриншот» в «Лог», в оркестраторе — на странице задания.

Пример #

{
  "type": "ui.getText",
  "props": {
    "selector": { "kind": "uia", "path": [ { "processName": "Tulpar.TestApp", "controlType": "Window", "name": "Tulpar Test App" }, { "controlType": "Text", "automationId": "lblResult" } ] }
  },
  "out": { "text": "result" }
}