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

Найти элемент

Тип узла: browser_getElementRef

Назначение

Находит элемент и возвращает его дескриптор для последующих действий с элементом.

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

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

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

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

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

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

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

  • Узел находит и возвращает реальную ссылку на элемент. Повторно использовать ссылку можно только в пределах того же запуска или при отладке в пределах той же эпохи.
  • Код ошибки проверки: 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

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

Режим outputRange eq "single"

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

Режим outputRange eq "all"

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

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

Пример JSON

Полный объект узла для массива nodes сценария или для blocks другого узла.

{
  "id": "find_button",
  "type": "browser_getElementRef",
  "data": {
    "title": "Find the submit button",
    "browserAction": "getElementRef",
    "browserUi": {
      "inputs": {
        "selectorType": "selector",
        "selectorRadio": "CSS",
        "selector": "button[type=submit]",
        "outputRange": "single",
        "serialType": "fixed",
        "serial": 1,
        "type": "object"
      },
      "exception": {
        "timeout": 30000,
        "policy": "interrupt"
      }
    }
  }
}

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