Перейти к содержимому

Прочитать данные элемента

Тип узла: browser_getElement

Назначение

Читает текст, HTML или указанный атрибут одного или нескольких найденных элементов.

Настройки в настольном клиенте

Настройки узла «Прочитать данные элемента» в настольном клиенте

Снимок сделан в английском интерфейсе MoreLogin Desktop V2.73.101.

Входные данные

Эти поля указываются в data.browserUi.inputs.

ПолеТип или значенияОбязательно по схемеПо умолчанию при выполненииОписание и ограничения
selectorType"selector" / "element" / "frame" (поддерживает ссылки на переменные)Нет"selector"Источник элемента. Начальное значение в редакторе: "selector"
framestringНет—Переменная iframe
elementstringНет—Переменная элемента
selectorRadio"CSS" / "XPath" (поддерживает ссылки на переменные)Нет"CSS"Тип селектора. Начальное значение в редакторе: "CSS". Например, "${locatorType}"; значение, на которое указывает ссылка, должно быть "CSS" или "XPath".
selectorstringНет—Селектор
outputRange"single" / "all" (поддерживает ссылки на переменные)Нет"single"Если совпадает несколько элементов. Начальное значение в редакторе: "single"
serialType"fixed" / "randomInterval" (поддерживает ссылки на переменные)Нет"fixed"Если совпадает несколько элементов. Начальное значение в редакторе: "fixed"
serialWorkflowNumberНет1Индекс элемента; целое число; минимум после вычисления: 1. Начальное значение в редакторе: 1
serialMinWorkflowNumberНет—Минимальный индекс; целое число; минимум после вычисления: 1
serialMaxWorkflowNumberНет—Максимальный индекс; целое число; минимум после вычисления: 1
type"innerText" / "innerHTML" / "attribute" (поддерживает ссылки на переменные)Нет"innerText"Тип выходных данных. Начальное значение в редакторе: "innerText"
keystringНет—Имя атрибута / селектор дочернего элемента

Требования к режимам и ограничения

  • Правила поиска элемента: для selectorType=selector нужен selector; для frame нужны frame+selector; для element нужна ссылка ElementRef из предыдущего узла. serial начинается с 1. randomInterval использует serialMin/serialMax, и минимум не может быть больше максимума. Сначала узел ждёт, пока селектор найдёт элементы, затем один раз выбирает индекс: верхняя граница диапазона ограничивается фактическим числом совпадений. Если фиксированный индекс или нижняя граница диапазона больше числа совпадений, сразу возвращается ELEMENT_NOT_FOUND (reason=range, details.field равно serial или serialMin), и никаких действий со страницей не выполняется. outputRange может быть только single/all. type может быть только innerText/innerHTML/attribute (как в редакторе; для объектов элементов используйте getElementRef, а для iframe используйте getFrame), а для type=attribute нужен key (имя атрибута). Читайте возвращённые ключи и значения как одно значение или как массив в зависимости от ветви. Узел не ждёт появления элемента: если ничего не найдено, он сразу завершается успешно, одиночное значение равно пустой строке "" (для all это []), а отсутствующий атрибут равен "". Если нужно дождаться элемента, сначала используйте узел «Дождаться элемента».
  • Код ошибки проверки: RPA_NODE_INPUT_INVALID

Ссылки во входных данных

ПолеДопустимые формы
selectorTypeliteral, template
frameliteral, template
elementliteral, template
selectorRadioliteral, template
selectorliteral, template
outputRangeliteral, template
serialTypeliteral, template
serialliteral, numericExpression
serialMinliteral, numericExpression
serialMaxliteral, numericExpression
typeliteral, template
keyliteral, template

Выходные данные

Режим {"op":"and","rules":[{"op":"eq","field":"type","value":"innerText"},{"op":"eq","field":"outputRange","value":"single"}]}

Поле выходных данныхТип или значения
textstring
matchedCountnumber

Режим {"op":"and","rules":[{"op":"eq","field":"type","value":"innerText"},{"op":"eq","field":"outputRange","value":"all"}]}

Поле выходных данныхТип или значения
textarray<string>
matchedCountnumber

Режим {"op":"and","rules":[{"op":"eq","field":"type","value":"innerHTML"},{"op":"eq","field":"outputRange","value":"single"}]}

Поле выходных данныхТип или значения
htmlstring
matchedCountnumber

Режим {"op":"and","rules":[{"op":"eq","field":"type","value":"innerHTML"},{"op":"eq","field":"outputRange","value":"all"}]}

Поле выходных данныхТип или значения
htmlarray<string>
matchedCountnumber

Режим {"op":"and","rules":[{"op":"eq","field":"type","value":"attribute"},{"op":"eq","field":"outputRange","value":"single"}]}

Поле выходных данныхТип или значения
attributestring / null
matchedCountnumber

Режим {"op":"and","rules":[{"op":"eq","field":"type","value":"attribute"},{"op":"eq","field":"outputRange","value":"all"}]}

Поле выходных данныхТип или значения
attributearray<string / null>
matchedCountnumber

Ссылайтесь на опубликованные поля в виде ${nodeId.data.field}.

Пример JSON

В этом примере текст первого элемента, соответствующего .price, читается в data.text. Если элемент загружается асинхронно, сначала добавьте узел «Дождаться элемента».

{
  "id": "read_price",
  "type": "browser_getElement",
  "data": {
    "title": "Read the product price",
    "browserAction": "getElement",
    "browserUi": {
      "inputs": {
        "selectorType": "selector",
        "selectorRadio": "CSS",
        "selector": ".price",
        "outputRange": "single",
        "serialType": "fixed",
        "serial": 1,
        "type": "innerText"
      },
      "exception": {
        "timeout": 30000,
        "policy": "interrupt"
      }
    }
  }
}

Назад к каталогу узлов