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

Цикл

Тип узла: browser_loop

Назначение

Повторяет блок заданное число раз, по коллекции, по списку элементов или по условию.

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

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

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

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

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

ПолеТип или значенияОбязательно по схемеПо умолчанию при выполненииОписание и ограничения
loopMode"times" / "elements" / "list" / "while" (поддерживает ссылки на переменные)Нет"times"Режим цикла. Начальное значение в редакторе: "times"
timesWorkflowNumberНет3Число повторений; целое число; минимум после вычисления: 1; максимум после вычисления: 10000. Начальное значение в редакторе: 3
selectorRadio"CSS" / "XPath" (поддерживает ссылки на переменные)Нет"CSS"Тип селектора. Начальное значение в редакторе: "CSS"
selectorstringНет—Селектор
serialWorkflowNumberНет1Индекс элемента; целое число; минимум после вычисления: 1. Начальное значение в редакторе: 1
type"object" / "innerText" / "innerHTML" / "attribute" / "contentFrame" (поддерживает ссылки на переменные)Нет"innerText"Тип выходных данных. Начальное значение в редакторе: "innerText"
keystringНет—Имя атрибута / селектор дочернего элемента
content["null","boolean","number","string"] / array<JSON> / object (поддерживает ссылки на переменные)Нет—Данные списка
loopConditionsarray<object>Нет—Пока выполняются условия
maxIterationsWorkflowNumberНет10000Максимальное число итераций; целое число; минимум после вычисления: 1; максимум после вычисления: 10000. Начальное значение в редакторе: 10000
accumulatorMode"none" / "collect" / "count" / "sum" (поддерживает ссылки на переменные)Нет"none"Режим накопления. Начальное значение в редакторе: "none"
initialState["null","boolean","number","string"] / array<JSON> / object (поддерживает ссылки на переменные)Нет—Начальное накопленное значение
accumulatorPathstringНет—Путь к накапливаемому полю (оставьте пустым, чтобы использовать результат текущей итерации)
breakEnabledboolean (поддерживает ссылки на переменные)НетfalseУсловие досрочного выхода. Начальное значение в редакторе: false
breakConditionobjectНет—Выйти при выполнении условия

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

  • Все четыре типа циклов соблюдают ограничение maxIterations (цикл while, достигший лимита, завершается штатно с exitReason=max_iterations). accumulatorMode задаёт none/collect/count/sum (если не указан, none), initialState задаёт начальное значение, accumulatorPath читает значение внутри data последнего узла, а breakEnabled/breakCondition управляют досрочным выходом. Для while loopConditions принимает только массив правил [{field,operator,value}]. index начинается с 1. Для списка объектов item={key,value}. type может быть только object/innerText/innerHTML/attribute/contentFrame, а для type=attribute нужен key. Пропущенная ветвь не использует повторно выходные данные предыдущей итерации.
  • Код ошибки проверки: RPA_NODE_INPUT_INVALID

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

ПолеДопустимые формы
loopModeliteral, template
timesliteral, numericExpression
selectorRadioliteral, template
selectorliteral, template
serialliteral, numericExpression
typeliteral, template
keyliteral, template
contentliteral, template
loopConditionsliteral
maxIterationsliteral, numericExpression
accumulatorModeliteral, template
initialStateliteral, template
accumulatorPathliteral, template
breakEnabledliteral, template
breakConditionliteral

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

Поле выходных данныхТип или значения
indexnumber / null
item["null","boolean","number","string"] / array<JSON> / object
totalnumber
iterationCountnumber
completedCountnumber
exitedboolean
state["null","boolean","number","string"] / array<JSON> / object
resultsarray<["null","boolean","number","string"] / array<JSON> / object>
exitReason"break" / "condition_false" / "max_iterations" / "completed"

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

Пример JSON

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

{
  "id": "repeat_three_times",
  "type": "browser_loop",
  "data": {
    "title": "Repeat the check three times",
    "browserAction": "loop",
    "browserUi": {
      "inputs": {
        "loopMode": "times",
        "times": 3,
        "accumulatorMode": "none"
      }
    }
  },
  "blocks": [
    {
      "id": "reload_each_time",
      "type": "browser_refreshPage",
      "data": {
        "title": "Reload the page",
        "browserAction": "refreshPage",
        "browserUi": {
          "inputs": {
            "postWaitMs": 1000
          },
          "exception": {
            "timeout": 30000,
            "policy": "interrupt"
          }
        }
      }
    }
  ]
}

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