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

Нажать на элемент

Тип узла: browser_click

Назначение

Нажимает на выбранный элемент на странице.

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

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

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

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

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

ПолеТип или значенияОбязательно по схемеПо умолчанию при выполненииОписание и ограничения
selectorType"selector" / "element" / "frame" (поддерживает ссылки на переменные)Нет"selector"Источник элемента. Начальное значение в редакторе: "selector"
framestringНет—Переменная iframe
elementstringНет—Переменная элемента
selectorRadio"CSS" / "XPath" (поддерживает ссылки на переменные)Нет"CSS"Тип селектора. Начальное значение в редакторе: "CSS"
selectorstringНет—Селектор
serialType"fixed" / "randomInterval" (поддерживает ссылки на переменные)Нет"fixed"Если совпадает несколько элементов. Начальное значение в редакторе: "fixed"
serialWorkflowNumberНет1Индекс элемента; целое число; минимум после вычисления: 1. Начальное значение в редакторе: 1
serialMinWorkflowNumberНет—Минимальный индекс; целое число; минимум после вычисления: 1
serialMaxWorkflowNumberНет—Максимальный индекс; целое число; минимум после вычисления: 1
button"left" / "right" / "middle" (поддерживает ссылки на переменные)Нет"left"Кнопка мыши. Начальное значение в редакторе: "left"
type"click" / "dblclick" (поддерживает ссылки на переменные)Нет"click"Способ нажатия. Начальное значение в редакторе: "click"
useMouseboolean (поддерживает ссылки на переменные)НетfalseИспользовать координаты смещения мыши. Начальное значение в редакторе: false
mouseXWorkflowNumberНет—Диапазон смещения по горизонтали (px); минимум после вычисления: 0
mouseYWorkflowNumberНет—Диапазон смещения по вертикали (px); минимум после вычисления: 0
relseaseDelayWorkflowNumberНет—Интервал между нажатием и отпусканием (ms); минимум после вычисления: 0
postWaitMsWorkflowNumberНет300Ожидание после завершения (ms); минимум после вычисления: 0. Начальное значение в редакторе: 300

В контракте узла поле relseaseDelay пишется именно так. Передавайте имя поля точно в указанном виде.

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

  • Правила поиска элемента: для selectorType=selector нужен selector; для frame нужны frame+selector; для element нужна ссылка ElementRef из предыдущего узла. serial начинается с 1. randomInterval использует serialMin/serialMax, и минимум не может быть больше максимума. Сначала узел ждёт, пока селектор найдёт элементы, затем один раз выбирает индекс: верхняя граница диапазона ограничивается фактическим числом совпадений. Если фиксированный индекс или нижняя граница диапазона больше числа совпадений, сразу возвращается ELEMENT_NOT_FOUND (reason=range, details.field равно serial или serialMin), и никаких действий со страницей не выполняется.
  • Код ошибки проверки: RPA_NODE_INPUT_INVALID

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

ПолеДопустимые формы
selectorTypeliteral, template
frameliteral, template
elementliteral, template
selectorRadioliteral, template
selectorliteral, template
serialTypeliteral, template
serialliteral, numericExpression
serialMinliteral, numericExpression
serialMaxliteral, numericExpression
buttonliteral, template
typeliteral, template
useMouseliteral, template
mouseXliteral, numericExpression
mouseYliteral, numericExpression
relseaseDelayliteral, numericExpression
postWaitMsliteral, numericExpression

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

Поле выходных данныхТип или значения
tabIdstring
elementElementRef
clickedtrue
urlstring
titlestring
openedTabsarray<TabInfo>

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

Пример JSON

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

{
  "id": "click_submit",
  "type": "browser_click",
  "data": {
    "title": "Click the submit button",
    "browserAction": "click",
    "browserUi": {
      "inputs": {
        "selectorType": "selector",
        "selectorRadio": "CSS",
        "selector": "button[type=submit]",
        "serialType": "fixed",
        "serial": 1,
        "button": "left",
        "type": "click",
        "postWaitMs": 300
      },
      "exception": {
        "timeout": 30000,
        "policy": "interrupt"
      }
    }
  }
}

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