# Сценарий, переменные и структурные узлы

На этой странице описана структура сценариев; это справочник для разработчиков и AI-агентов, которые пишут сценарии. Используйте вместе с этой страницей [схему структуры](/ru/browser-rpa/local-api#%D0%BB%D0%BE%D0%BA%D0%B0%D0%BB%D1%8C%D0%BD%D1%8B%D0%B9-%D0%BC%D0%B0%D1%88%D0%B8%D0%BD%D0%BE%D1%87%D0%B8%D1%82%D0%B0%D0%B5%D0%BC%D1%8B%D0%B9-%D0%BA%D0%BE%D0%BD%D1%82%D1%80%D0%B0%D0%BA%D1%82); за семантику отвечает [эндпоинт проверки](/ru/browser-rpa/api/validate-workflow). Чтобы начать работу, см. [Справочник Local API](/ru/browser-rpa/local-api) и [Быстрый старт](/ru/browser-rpa/quickstart).

## 1. Документ и порядок

```json
{
  "editorVersion": 2,
  "editorParametersVersion": 1,
  "variables": {
    "type": "object",
    "properties": {}
  },
  "nodes": [
    {
      "id": "start",
      "type": "start"
    },
    {
      "id": "end",
      "type": "end",
      "data": {
        "inputsValues": {
          "status": {
            "type": "constant",
            "content": "success"
          },
          "message": {
            "type": "constant",
            "content": "Done"
          }
        }
      }
    }
  ]
}
```

При записи принимаются только editorVersion=2 и editorParametersVersion=1. Данные с версией параметров 2 по-прежнему можно прочитать в исходном виде, но внешние вызывающие стороны не переписывают их молча. Изменяйте такие данные только после явной миграции в настольном клиенте. Порядок в массиве определяет порядок выполнения, а blocks выражают вложенность. Рёбер, соединений и состояний активации нет.

В корневом массиве первым идёт start, а последним end, ровно по одному. У каждого узла уникальный id. Рекомендуем, чтобы ID начинался с буквы ASCII, далее содержал буквы, цифры или символы подчёркивания и был не длиннее 64 символов. В качестве ID нельзя использовать зарезервированные имена редактора `system`, `initVars` и `custom`. ID групп и ветвей также учитываются при проверке уникальности. Обычное действие использует type=`browser_<action>`, data.browserAction должен ему соответствовать, а входные данные действия помещаются в data.browserUi.inputs.

Общая область данных содержит title/description, meta (данные JSON для отображения) и data.inputs/outputs (описания для редактора; outputs узлов действий генерирует сервер, см. [Поля, которые заполняет сервер](#%D0%BF%D0%BE%D0%BB%D1%8F-%D0%BA%D0%BE%D1%82%D0%BE%D1%80%D1%8B%D0%B5-%D0%B7%D0%B0%D0%BF%D0%BE%D0%BB%D0%BD%D1%8F%D0%B5%D1%82-%D1%81%D0%B5%D1%80%D0%B2%D0%B5%D1%80)). Значения в browserUi.test и смоделированные результаты инициализации не являются фактическими результатами, поэтому не принимайте на их основе решения о запуске. Сводный контракт каждого типа узла см. в разделе [статические контракты узлов](/ru/browser-rpa/nodes). Он охватывает структуру входных данных, значения по умолчанию, условия, варианты выходных данных и политики полей.

## 2. Начальные переменные: шесть типов полей

variables=`{type:'object',properties:{fieldName:Variable},required?:string[]}`. Имена параметров могут содержать китайские иероглифы. Имя не может быть пустым после удаления пробелов по краям, не может содержать `.`, `[`, `]`, `${` или `}` и не может совпадать с custom/system/parameters или с ID любого узла в этом сценарии. Имена `__proto__`, `constructor` и `prototype` запрещены. Каждый элемент required должен существовать в properties, а повторяющиеся элементы отклоняются.

Публичный Variable может использовать следующие свойства: type, description, default и extra. Свойство extra содержит описанную ниже конфигурацию редактора. Публичная запись отклоняет неизвестные поля, которые влияют на выполнение, а в конфигурации отображения допускаются только опубликованные поля. Поле обязательно, если `extra.required=true` или если оно указано в списке required верхнего уровня. Рекомендуем использовать только required верхнего уровня. Если эти два способа противоречат друг другу, запись возвращает 422, чтобы AI-агенты не полагались на неявный приоритет.

| Бизнес-тип | Объявление | Конфигурация extra и значения по умолчанию | Обычное значение при запуске |
|  --- | --- | --- | --- |
| Строка | type=string | extra.private=false, localPath=false; charValid={enabled:false,value:…}; multiline={value:1,autoHeight:true} | kind=json, value является строкой |
| Число | type=number; для целых чисел также можно использовать type=integer | decimalPlaces: по умолчанию 2 для number, для integer всегда 0 (как в редакторе); numberRange={enabled:false,min:null,max:null}; numberSuffix={enabled:false,value:''} | kind=json, value является конечным числом; диапазон и точность должны соответствовать объявлению |
| Логическое значение | type=boolean | Бизнес-настроек extra нет | kind=json, value является логическим значением |
| Массив | type=array | multiline={value:1,autoHeight:true} | kind=json, value является массивом JSON; не передавайте вместо него строку JSON |
| Объект | type=object | multiline={value:1,autoHeight:true} | kind=json, value является объектом JSON |
| Файл | type=object для одного файла, type=array для нескольких файлов; extra.type=file | multipleFiles={enabled:false,unlimited:false,maxCount:9} (для нескольких файлов без maxCount допускается до 9 файлов, и только unlimited=true снимает ограничение на количество); formatType является массивом расширений файлов; sizeLimit={unit:'KB' или 'MB',value:положительное число}, а если sizeLimit не указан, каждый файл может быть не больше 10MB (как в редакторе) | kind=json, value является строкой с абсолютным локальным путём (один файл) или массивом строк (несколько файлов). Сервер ссылается на файл по этому пути напрямую, так же как при запуске в клиенте, без копирования. Путь должен существовать и соответствовать ограничениям на расширение, количество и размер. url, который получает узел, и есть этот путь. Файловые параметры не могут объявлять значение по умолчанию |


Настройка multiline.value принимает целое число от 1 до 200. Для числа символов, точности и ограничений на файлы определяющим является действующий контракт; не используйте фиктивные данные из интерфейса. Поля extra.name/index/placeholder служат для отображения и не меняют имя, по которому ссылаются на параметр. fieldId является ключом в properties.

У обычного значения по умолчанию есть два существующих представления в редакторе. Рекомендуется Variable.default, а extra.defaultValue={enabled:true,value:…} поддерживается для совместимости. Явное значение extra.defaultValue.enabled=false означает, что значения по умолчанию нет. При enabled=true применяется его value. Если задан ещё и default и значения различаются, публичная запись возвращает RPA_DEFAULT_CONFLICT, а не выбирает одно из них молча. Значение по умолчанию для массива или объекта является значением JSON. Запуск не может начаться, если обязательное значение отсутствует и значения по умолчанию нет. Пропуск необязательного значения отличается от явной передачи null или пустого массива, а null должен проходить проверку для целевого поля.

```json
{
  "type": "object",
  "properties": {
    "targetUrl": {
      "type": "string",
      "description": "Target URL",
      "default": "https://example.com"
    },
    "count": {
      "type": "integer",
      "default": 2,
      "extra": {
        "decimalPlaces": 0,
        "numberRange": {
          "enabled": true,
          "min": 1,
          "max": 10
        }
      }
    },
    "enabled": {
      "type": "boolean",
      "default": true
    },
    "items": {
      "type": "array",
      "default": []
    },
    "settings": {
      "type": "object",
      "default": {}
    },
    "attachment": {
      "type": "object",
      "extra": {
        "type": "file",
        "multipleFiles": {
          "enabled": false
        },
        "formatType": [
          "txt"
        ],
        "sizeLimit": {
          "unit": "KB",
          "value": 100
        }
      }
    }
  },
  "required": [
    "targetUrl"
  ]
}
```

Сценарии с файловыми параметрами или со строковыми параметрами с localPath=true поддерживают внешний запуск так же, как запуск в клиенте. Во время запуска передайте локальный путь.

## 3. Приватные значения по умолчанию

Приватная переменная должна иметь type=string и extra.private=true. Local API не скрывает приватные значения. Можно передать значение по умолчанию открытым текстом, GET возвращает значение по умолчанию открытым текстом, а сценарий с приватными параметрами поддерживает внешний запуск (при запуске можно передавать открытый текст напрямую; см. [ParameterValues](/ru/browser-rpa/api/data-types#parametervalues)).

Запись значения по умолчанию открытым текстом:

```json
{
  "type": "string",
  "default": "p@ssw0rd",
  "extra": {
    "private": true,
    "defaultValue": {
      "enabled": true,
      "value": "p@ssw0rd"
    }
  }
}
```

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

| Случай записи или чтения | Правило |
|  --- | --- |
| POST/PUT/node-edits передаёт default или defaultValue.value открытым текстом | Записывается в облачный шаблон как есть; сохранение выполняется успешно |
| GET сведений о шаблоне | Приватные значения по умолчанию возвращаются открытым текстом в виде `default` и `defaultValue:{enabled:true,value}`; `redactedPaths` всегда равно `[]` |
| Ответы эндпоинтов записи (создание, обновление, копирование, правки узлов) | Так же, как GET; приватные значения по умолчанию возвращаются открытым текстом |
| Квитанции идемпотентности (повторное воспроизведение с тем же ключом, результат `GET /requests/{key}`) | Квитанции не хранят содержимое шаблона. При повторном воспроизведении сервер заново читает облачный шаблон и возвращает его текущее содержимое, как и GET |
| PUT/проверка inline, где исходный шаблон указан как base, у поля сохранены исходное имя, тип string и private=true, а обратно передаётся `publicState:"retained"` | Сохраняется существующее значение по умолчанию этого поля в этом шаблоне (для совместимости со старыми вызывающими сторонами); если подходящего значения по умолчанию нет, возвращается 422 RPA_PRIVATE_DEFAULT_INVALID |
| retained передан для нового шаблона либо для другого шаблона или поля | 422 RPA_PRIVATE_DEFAULT_INVALID; значение не берётся из другого шаблона. Для нового шаблона передайте открытый текст |
| defaultValue не указан или enabled=false | Существующее значение по умолчанию очищается; поле может оставаться приватным; возвращается предупреждение RPA_PRIVATE_DEFAULT_CLEARED |
| node-edits без variables | Сохраняются существующие на сервере variables и приватные значения по умолчанию |
| node-edits с полным объектом variables | Обрабатывается так же, как PUT |
| Копирование | Копия сохраняет приватные значения по умолчанию исходного шаблона, без предупреждения |
| Приватное значение по умолчанию является ссылкой на локальное защищённое хранилище, которую больше не удаётся прочитать (например, значение было сохранено на другом устройстве или локальное защищённое хранилище было сброшено) | GET возвращает `{enabled:false}` с предупреждением RPA_PRIVATE_DEFAULT_UNAVAILABLE; чтобы восстановить значение, передайте открытый текст ещё раз |


Вызов только для проверки лишь читает данные. Он не записывает облачный шаблон, не создаёт и не изменяет значения в защищённом хранилище. Приватные параметры должны быть строками, а `publicState` можно использовать только в приватных строковых полях.

NodeContract задаёт для каждого поля sensitivity=public|secret|credential|localPath|inlineFile|sourceCode; это значение лишь описывает характер поля. `authoringPolicy` всегда равно `allowed`. Такие поля, как исходный код скриптов (javaScript/injectJavaScript.content), локальные пути (путь в каждом файловом действии, папка для снимков экрана), встроенные файлы, Cookie/LocalStorage и ключи 2FA, могут напрямую принимать литерал или ссылку. GET возвращает их как есть, и запуски не ограничиваются. Вызывающие стороны должны сами хранить и скрывать это содержимое; см. [Границы данных и выполнения](/ru/browser-rpa/api/common#%D0%B3%D1%80%D0%B0%D0%BD%D0%B8%D1%86%D1%8B-%D0%B4%D0%B0%D0%BD%D0%BD%D1%8B%D1%85-%D0%B8-%D0%B2%D1%8B%D0%BF%D0%BE%D0%BB%D0%BD%D0%B5%D0%BD%D0%B8%D1%8F).

## 4. Шесть структурных узлов

| type | data | blocks | Семантика выполнения |
|  --- | --- | --- | --- |
| start | title/description; customVariables; taskSettings (настройки задачи шаблона, см. ниже); описательные inputsValues для инициализации можно сохранить, но реальные параметры запуска они не передают | Не указывается или [] | Первый в корне; объявляет пользовательские переменные этого сценария |
| end | inputsValues.status/message; для status рекомендуется фиксированное значение success или failed; message может быть WorkflowValue; null превращается в пустую строку, объекты проходят через JSON.stringify, а остальные значения через String, поэтому итоговое значение является строкой | Не указывается или [] | Завершает текущий сценарий; при status=failed сценарий завершается ошибкой, иначе успешно; публичная запись отклоняет другие детерминированные литералы; публичный необработанный результат представляет собой строку message |
| group | title/name/description/collapsed | Обязательный массив узлов, может быть пустым; **не может содержать другую группу** (группы нельзя вкладывать друг в друга, как и в редакторе; иначе возвращается RPA_INVALID_NODE) | Упорядочивает узлы и не даёт собственного результата выполнения, на который можно сослаться; во время выполнения группа разворачивается в плоский список, но в сохранённом сценарии группа остаётся |
| case | title/description необязательны (рекомендуем описать смысл ветви; если title не указан, подставляется название по умолчанию `分支`); conditionGroups:[{content:Condition[]}], **допускается только одна группа** | Обязательный массив узлов | Только непосредственно внутри ifElse; условия в группе объединяются через AND; чтобы выразить «или», добавьте ветви; выбирается первая подходящая ветвь case в порядке их следования |
| caseDefault | title/description необязательны (рекомендуем описать смысл ветви; если title не указан, подставляется название по умолчанию `默认分支`) | Обязательный массив узлов | Выполняется, только если в ifElse не подошла ни одна ветвь case; допускается не более одной такой ветви, и она должна быть последней |
| exceptionBlock | title/description необязательны | Обязательный массив узлов, может быть пустым | Используется только как непосредственные blocks узла с настройкой «Выполнить ветвь обработки исключений»; ровно два блока: первым идёт ветвь успеха, вторым ветвь сбоя; см. [Ветви обработки исключений](#%D0%B2%D0%B5%D1%82%D0%B2%D0%B8-%D0%BE%D0%B1%D1%80%D0%B0%D0%B1%D0%BE%D1%82%D0%BA%D0%B8-%D0%B8%D1%81%D0%BA%D0%BB%D1%8E%D1%87%D0%B5%D0%BD%D0%B8%D0%B9) |


Объект start.data.taskSettings содержит настройки уровня шаблона, которые редактор сохраняет из раздела «Настройки задачи». GET возвращает их как есть; их можно записать обратно без изменений или изменить. Поля и значения см. в `$defs.start` в workflow.schema.json. Настройки действуют только при реальных запусках (запуск всего сценария в редакторе, запуск через Local API или запланированная задача). При пошаговой отладке и отладке группы они не действуют; taskSettings в вызываемом дочернем шаблоне тоже не действуют. Основные моменты:

- delayMinutes: сначала запуск остаётся в очереди, не занимая окружение, а браузер открывается только в момент `startAfter` (поле сводки запуска; для запланированных задач отсчёт ведётся от запланированного времени). Пока запуск находится в очереди, его можно отменить.
- timeoutSeconds: отсчёт времени начинается, когда заканчивается задержка и запускается браузер. При тайм-ауте браузер основного окружения закрывается, а запуск завершается ошибкой с кодом RPA_TASK_TIMEOUT. Узлы, которые выполнялись в момент тайм-аута (включая охватывающие их узлы цикла, условия и дочернего сценария), также записываются как failed с RPA_TASK_TIMEOUT. Они не повторяются и не проходят обработку исключений. Тайм-аут задачи и тайм-ауты узлов действуют независимо.
- completionTabs / completionBrowser: после успешного завершения или сбоя эти настройки применяются к основному окружению (окружению, в котором был начат запуск). Если пользователь останавливает запуск, ничего не выполняется. Окружения, открытые узлом «Запустить браузер», не затрагиваются.
- headless, launchArguments, disableAutofill, allowSavePasswords и clearCacheOnClose применяются только к браузерам, запущенным в рамках этого запуска (включая запущенные узлом «Запустить браузер»). На окружения, которые уже были открыты до запуска, они не влияют. Браузеру в режиме headless требуется ядро браузера версии 130 или новее (иначе RPA_HEADLESS_CORE_UNSUPPORTED), и он всегда закрывается по окончании задачи, в том числе когда пользователь её останавливает.


Публичная запись case принимает только conditionGroups ровно с одной группой условий (как в редакторе; при нескольких группах возвращается RPA_WORKFLOW_SCHEMA_INVALID с reason=limit). При чтении устаревшего inputsValues.condition граница API преобразует его в conditionGroups из одного элемента. Если присутствуют обе формы, это структурная ошибка внутри сценария: сохранение или обновление возвращает 422, а вызов только для проверки возвращает 200 с valid=false и замечанием. Ни одну из форм нельзя молча игнорировать. Каждая группа должна быть непустой, и каждому условию нужен левый операнд. Доступны операторы eq/ne/gt/lt/gte/lte/contains/notContains/exists/notExists, и только exists/notExists могут не указывать right. Операторы gt/gte/lt/lte сравнивают числа или числовые строки. Если одна из сторон равна null (например, ссылка на узел, который был пропущен после сбоя), условие не выполняется. Другие значения, которые невозможно преобразовать в числа, возвращают VALUE_CONVERSION_FAILED. Записывайте операнд как константу `{"type":"constant","content":…}` или как ссылку `{"type":"ref","content":["nodeId","data","field"]}`. content ссылки **должен быть массивом сегментов пути** (как в редакторе). Если записать его строкой `"nodeId.data.field"`, редактор считает поле незаполненным, а запись возвращает RPA_NODE_INPUT_INVALID (reason=required). Превратить всю группу условий в ref нельзя.

Корневой workflow.outputs является фактическим сопоставлением выходных данных сценария, в отличие от описаний для редактора в data.outputs узла. Если он не объявлен явно, среда выполнения выводит `{result:"${<endId>.data.result}"}` из узла end в конце корня. Явно заданный workflow.outputs переопределяет это значение по умолчанию; именно поэтому call_child.data.outputs.result в примере дочернего сценария берётся из этого сопоставления. Каждая ссылка в объявлении также проходит проверки области видимости, типа и политики запуска.

Структурные узлы не считаются исполняемыми действиями, поэтому при чтении возможностей не считайте start или group отсутствующими во время выполнения. Узел breakLoop является управляющим действием. Его можно размещать только в теле цикла текущего сценария, а его blocks должны отсутствовать или быть пустыми. Выход из цикла в дочернем сценарии не может прервать цикл вызывающего сценария.

При создании цикла всегда указывайте `"accumulatorMode": "none"` (другое значение указывайте, когда нужно накапливать результаты); это соответствует циклам, созданным в редакторе клиента. Если поле не указано, оно считается равным `none`, что соответствует отображению в редакторе. Выходное значение цикла `index` содержит номер текущей итерации и **начинается с 1** (первая итерация имеет номер 1). В режиме times `item` совпадает с `index`. В режиме list/elements `item` содержит текущий элемент или значение, а для списка объектов `item` равно `{key,value}`. Для полей, которые выбирают N-й элемент по позиции (например, serial в getElement, который тоже начинается с 1), ссылайтесь на `${loopId.data.index}` напрямую и не прибавляйте 1. После завершения цикла `index` содержит номер последней итерации или 0, если цикл не выполнился ни разу. В режиме while записывайте loopConditions только как массив правил `[{"field":"index","operator":"lt","value":3}]` (как в редакторе; группа условий `{content:[…]}` не принимается). При достижении maxIterations цикл завершается штатно, а exitReason равен max_iterations.

## 5. Пользовательские переменные и ссылки

Каждый элемент start.data.customVariables имеет вид `{id,name,type,initialValue}`. Его type принимает значения string/number/boolean/array/object, и initialValue должен соответствовать типу. id должен быть уникальным и представимым в синтаксисе пути. Ссылайтесь на переменную через `${custom.<id>}`, а не по имени. Пользовательские переменные инициализируются независимо для каждого полного запуска и для каждого вызова дочернего сценария. Публичный API не предоставляет отладку, поэтому значения не наследуются между запусками.

Записывать пользовательские переменные можно только одним способом (как в редакторе): объявите их в start.data.customVariables и изменяйте с помощью `browser_updateCustomVariable`. variableId должен быть статическим и уже объявленным, а операция должна подходить к типу переменной. Динамически записывать произвольные параметры или системные переменные нельзя. В редакторе нет узла setCustomVariable, поэтому попытка записать такой узел возвращает RPA_WORKFLOW_SCHEMA_INVALID. Узел setCustomVariable, оставшийся в существующем шаблоне, завершается ошибкой до запуска (RPA_ACTION_UNSUPPORTED с ID узла и путём).

```json
[
  {"id": "start", "type": "start", "data": {"customVariables": [{"id": "demoCounter", "name": "Counter", "type": "number", "initialValue": 0}]}},
  {"id": "set_counter", "type": "browser_updateCustomVariable", "data": {"browserAction": "updateCustomVariable",
    "browserUi": {"inputs": {"variableId": "demoCounter", "operation": "assign", "value": "2"}}}},
  {"id": "end", "type": "end", "data": {"inputsValues": {"status": {"type": "constant", "content": "success"},
    "message": {"type": "ref", "content": ["custom", "demoCounter"]}}}}
]
```

`${parameterName}` читает начальный параметр, `${nodeId.data.field}` читает данные выполнения узла, `${custom.id}` читает пользовательскую переменную, а `${system.browser.id}` и подобные пути читают системный контекст. Ссылка на значение целиком сохраняет исходный тип, а ссылка внутри составной строки преобразуется в текст. WorkflowNumber принимает число или ограниченное арифметическое выражение, но не объект ref. `${…}` может содержать только путь ссылки, но не арифметику: `${loop.data.index + 1}` возвращает RPA_REFERENCE_EXPRESSION_UNSUPPORTED. В числовом поле пишите `"${loop.data.index}+1"` (ссылка записывается отдельно, а арифметика выносится за пределы `${}`). Обычные текстовые поля не вычисляют арифметику. Ссылки в browserUi.inputs/bindings узла действия записываются **только как текст `${path}`** (как в редакторе), а не как объекты-обёртки вида `{type:'ref'}`. Поля элементов и фреймов тоже принимают только текст ссылки, например `${previousNode.data.element}`; не пишите объекты ElementRef/FrameRef вручную. Запись объекта-обёртки возвращает RPA_WORKFLOW_SCHEMA_INVALID или RPA_NODE_INPUT_INVALID (reason=format). Объект ref `{type:'ref',content:[pathSegments]}` используется только в inputsValues узла end и в операндах условных ветвей.

WorkflowValue (inputsValues узла end, операнды условий и key/value параметров скриптов) является обычным значением JSON или обёрткой constant/ref/expression. Если публичная семантическая проверка встречает зарезервированный ключ type=ref/constant/expression, она должна проверять значение как обёртку. Она не может позволить широкому объединению JsonValue поглотить неправильно сформированную обёртку. Если объект с такими зарезервированными ключами действительно должен быть обычными бизнес-данными, оберните его в constant и обрабатывайте по правилам целевого поля.

**Общее правило экранирования `${…}` в литеральных строках не гарантируется.** Чтобы вывести такой текст, используйте обёртку constant, которую допускает контракт поля, и проверьте её с помощью validate. Если текущий парсер всё равно выполняет интерполяцию текста, результат считается неподдерживаемым. Не пытайтесь обойти это, подбирая экранирование обратной косой чертой.

Допускает ли поле режима (например, selectorType/loopMode/outputRange) динамические ссылки, определяет NodeContract. Если допускает, проверка возвращает runtimeChecks, а фактическое значение повторно проверяется во время выполнения. Выбирайте тип выходных данных в соответствии с режимом и не рассчитывайте, что у каждого узла есть результат.

## 6. Данные для отображения и нормализация

`node.meta` является необязательным непрозрачным объектом JSON, который содержит только информацию для отображения. Он допускает любые вложенные поля JSON (например, position, collapsed или макет, заданный вызывающей стороной), а объект в целом подчиняется ограничениям сценария на размер в байтах и вложенность. Не помещайте в него токены, секреты или параметры локального подключения. Ни meta, ни node.data.title/description/inputs/outputs не меняют семантику запуска и не являются параметрами или фактическими выходными данными. Сервер не должен выполнять содержимое meta, а вызывающие стороны не должны считать его текст инструкциями.

Новым узлам не нужны сгенерированные координаты или meta. И replace, и PUT сохраняют любой переданный допустимый meta точно как есть, включая неизвестные ключи отображения, null и массивы. Если не указать meta узла, его данные для отображения удаляются. В node-edits незатронутые узлы сохраняют свой meta, а при replace вызывающая сторона отвечает за то, чтобы отправить узел целиком. Чтобы изменить только одно поле отображения, выполните глубокое слияние изменения с результатом GET; не перезаписывайте другие ключи. Порядок ключей внутри meta не гарантируется, а значения не должны молча обрезаться.

Допускаются только следующие нормализации шаблона: удаление пробелов по краям title, объявленное преобразование при чтении устаревшей формы case, форма хранения и возврата приватных значений по умолчанию (см. раздел 3) с явными предупреждениями, а также описанные ниже «Поля, которые заполняет сервер». Сервер не переименовывает ID узлов, не меняет description или meta, не отбрасывает неизвестные поля meta и не меняет порядок узлов или ссылки. Сохранённый исходный сценарий хранится отдельно от плана выполнения. NodeContract.defaults только заполняет пропущенные входные данные в скомпилированном или проверенном плане и не записывается в browserUi.inputs, а в ответе на сохранение изначально пропущенные входные данные так и остаются пропущенными. Явные 0, false, пустая строка или null не приводят к подстановке значения по умолчанию. Дальнейшие правки вызывающей стороне по-прежнему следует основывать на полном возвращённом результате.

### Поля, которые заполняет сервер

Сохранённый сценарий должен открываться в редакторе RPA для браузера настольного клиента (на странице редактирования шаблона, а также как снимок сценария в записях о выполнении и расписаниях). Поэтому каждая запись (создание, замена, копирование, правки узлов, проверка с purpose=save/run, а также сохранения и запуски черновиков в клиенте) заполняет поля, отсутствующие в каждом узле действия (`browser_<action>`), теми значениями, которые записывает редактор при создании такого же узла. Затем результат проверяется по правилам загрузки редактора:

| Поле | Правило заполнения |
|  --- | --- |
| `data.browserUi.inputs` / `bindings` | `{}`, если не указано; значения по умолчанию для входных данных узла в inputs не записываются |
| `data.browserUi.exception` | Если поле не указано или в нём не хватает части полей, каждое отсутствующее поле получает значение по умолчанию редактора (см. [Политика исключений узла](#%D0%BF%D0%BE%D0%BB%D0%B8%D1%82%D0%B8%D0%BA%D0%B0-%D0%B8%D1%81%D0%BA%D0%BB%D1%8E%D1%87%D0%B5%D0%BD%D0%B8%D0%B9-%D1%83%D0%B7%D0%BB%D0%B0-workflowexception)); явно записанные поля сохраняются как есть |
| `data.title` | Если не указано, подставляется название узла из редактора в исходной китайской формулировке. Это лишь запасной вариант. Указывайте название, которое описывает назначение узла. Если название не указано, пусто или совпадает с названием по умолчанию, сервер возвращает предупреждение `RPA_NODE_TITLE_GENERIC` (см. ниже) |
| `data.inputs` / `data.inputsValues` | Если не указаны, `{"type":"object","properties":{}}` и `{}` соответственно; inputsValues узла действия должен быть пустым объектом |
| `data.outputs` | Всегда генерируется сервером по типу узла и browserUi.inputs. Описывает переменные, на которые могут ссылаться последующие узлы. Вызывающим сторонам не нужно заполнять это поле; если они его заполнят, приоритет имеет сгенерированный результат |
| `data` узлов start / end | Отсутствующие ключи заполняются по узлам start и end, которые редактор создаёт для нового шаблона: start получает `title` `初始化`; end получает `title` `结束`, `inputs`/`inputsValues` (status=success и пустое message, что даёт тот же результат выполнения, что и их отсутствие) и `outputs`. Явно записанные ключи (включая собственный title и status=failed) сохраняются как есть |
| `data.title` для case / caseDefault | Если не указано, подставляются названия ветвей по умолчанию из редактора: `分支` для case и `默认分支` для caseDefault. Явно записанное название (включая пустую строку) сохраняется как есть |


В результате узлы действий и узлы start/end, прочитанные через GET, всегда содержат описанную выше полную структуру, а компактная форма при отправке (только browserAction и browserUi.inputs) по-прежнему допустима. Сценарий, который редактор не может открыть даже после заполнения полей (например, тип узла не соответствует browserAction или условная ветвь находится не внутри узла условия), возвращает 422, и issues.path указывает на соответствующий узел. Полное содержимое, которое сохраняет сам редактор клиента, никогда не переписывается.

**Напоминание о названиях**: редактор клиента показывает в шаблоне только названия узлов и ветвей. Поэтому создание, замена, правки узлов и `POST /validations` возвращают по одному предупреждению `RPA_NODE_TITLE_GENERIC` для каждого узла действия и каждой ветви case/caseDefault, название которых не указано, пусто или совпадает с названием по умолчанию в редакторе. У каждого предупреждения есть path, указывающий на `data/title` узла, и оно содержит `nodeId`. Предупреждение не мешает сохранению и запуску. Узлы start/end, group и exceptionBlock не проверяются, а при копировании шаблона это предупреждение не возвращается. Переименуйте такие узлы так, чтобы название описывало их назначение (например, «Дождаться появления результатов поиска» или «Найти целевое видео»).

## 7. Точное сопоставление итогового результата

При успешном выполнении вычисляется `end.data.inputsValues.message` → null превращается в `""`, объекты и массивы проходят через JSON.stringify, а остальные значения через String → данные выполнения узла end, `end.data.result` (строка). Если workflow.outputs не задан явно, компилятор выводит `{ "result": "${<endId>.data.result}" }`, поэтому `data.result.outputs.result` в ответе GET для запуска содержит именно эту строку. Если workflow.outputs задан явно, результат следует этому сопоставлению, и неявного поля result нет. При status=failed сценарий завершается сбоем и не претендует на успешный результат.

Например, если значение getUrl(type=search,key=item) равно `"42"` и end.message ссылается на это значение, итоговый outputs.result равен `"42"`. Если ключ не существует, getUrl.value="", а итоговый outputs.result равен `""`. Это не означает, что узел завершился ошибкой. Если end.message ссылается на весь объект data узла getUrl, результатом будет строка JSON этого объекта. Не путайте результат уровня узла с результатом уровня запуска.

## 8. URL и пределы доказательной силы проверки

Начальный параметр с URL достаточно объявить как string; URL не является отдельным типом переменной. При проверке перед сохранением фиксированный литерал в gotoUrl.url должен быть абсолютным URL HTTP(S). Для ссылки, у которой ещё нет значения для запуска, проверка сверяет её объявление и область видимости и включает её в runtimeChecks. Проверка не может утверждать, что URL действителен или доступен. Предварительная проверка перед запуском повторно сверяет формат URL с учётом фактических параметров. Доступность сайта, перенаправления и изменения страницы по-прежнему можно подтвердить только во время выполнения. Пустой массив runtimeChecks не доказывает, что запуск будет успешным. Если valid=false, исправьте проблемы и повторите проверку.

## 9. Формы ссылок, base и изменения отображения

Форма literal представляет собой обычное значение JSON для целевого поля. Форма template представляет собой строку, содержащую `${…}` (ссылка на значение целиком сохраняет свой тип, а в составной строке значение преобразуется в текст). Форма numericExpression представляет собой ограниченное арифметическое выражение с четырьмя основными операциями и числовыми ссылками в том виде, в каком его поддерживает WorkflowNumber; это не JavaScript. Форма reference имеет вид `{type:"ref",content:[pathSegments]}` и встречается только в inputsValues узла end и в операндах условий (в browserUi узла действия она не используется). Схема описывает, что возможно структурно, а referenceRules ограничивают формы, которые поле допускает публично. Должны выполняться оба условия. Поле gotoUrl.url поддерживает literal/template.

При getUrl.type=href и value, и url содержат полный текущий адрес на момент чтения, включая query/hash. Если при предыдущем переходе произошло перенаправление, это адрес текущей страницы после перенаправления. При origin value содержит схему, хост и порт. При search value содержит первое значение указанного ключа query или пустую строку, если ключа нет, а url по-прежнему содержит полный адрес.

Источник inline без base является самостоятельным кандидатом для нового шаблона. Сервер не может определить, из какого существующего шаблона он получен, поэтому не проверяет никакую сохранённую версию и не допускает retained. При изменении шаблона обязательно передавайте base, чтобы эту предварительную проверку защищала проверка версии. Для сохранения по-прежнему нужен If-Match. Если у вызывающей стороны нет доступа к base или к шаблону, сервер сначала возвращает 403/404, а не RPA_TEMPLATE_VERSION_CONFLICT, и не раскрывает версию.

Пользователь клиента, который сохраняет макет отображения или редактирует форму, тоже считается отдельным источником записи. Это должно увеличивать версию шаблона и делать старые ETag недействительными. Простое открытие шаблона не является операцией записи, которую гарантирует API, поэтому не делайте на его основании вывод, что версия не изменилась. Прежде чем продолжить редактирование, всегда заново читайте текущий шаблон.

## 10. Выбор узлов ожидания

Для «ожидания после перехода» можно использовать gotoUrl.postWaitMs или отдельный waitTime, и оба ожидания суммируются. Если пользователь также хочет отдельно редактировать узел ожидания, рекомендуем явно указать postWaitMs=0 и добавить отдельный waitTime: так ожидание не будет учтено дважды. Это вариант компоновки по умолчанию, а не ограничение протокола. Для waitTime значение fixed.timeout допускает конечное дробное число миллисекунд, но точность планирования при запуске не гарантируется. Оба конца randomInterval тоже допускают дробные значения (правила для значений см. в контракте browser_waitTime). meta в ответе (Metadata) содержит данные трассировки HTTP, а node.meta содержит данные для отображения на холсте. Ни одно из них нельзя использовать для заполнения другого.

При изменении ID узла нужно одновременно исправить все ссылки на него. Либо замените весь шаблон через PUT, либо в одном пакете node-edits удалите старый узел, вставьте новый и замените каждый узел, который на него ссылается. Сама операция replace не может изменить node.id. При любом подходе сначала проверьте полный кандидат, сохраните данные пользователя и используйте текущий If-Match и новый ключ намерения записи.

## Политика исключений узла (WorkflowException)

Конфигурация задаётся в `node.data.browserUi.exception`, на одном уровне с inputs и bindings. Внутри inputs она не записывается. Структуру полей, диапазоны значений и значения по умолчанию см. в [схеме WorkflowException](/ru/browser-rpa/local-api#%D0%BB%D0%BE%D0%BA%D0%B0%D0%BB%D1%8C%D0%BD%D1%8B%D0%B9-%D0%BC%D0%B0%D1%88%D0%B8%D0%BD%D0%BE%D1%87%D0%B8%D1%82%D0%B0%D0%B5%D0%BC%D1%8B%D0%B9-%D0%BA%D0%BE%D0%BD%D1%82%D1%80%D0%B0%D0%BA%D1%82).

Если не указан весь объект exception или любое из его полей, перед сохранением сервер заполняет каждое отсутствующее поле значением по умолчанию, которое редактор клиента задаёт для нового узла (см. [Поля, которые заполняет сервер](#%D0%BF%D0%BE%D0%BB%D1%8F-%D0%BA%D0%BE%D1%82%D0%BE%D1%80%D1%8B%D0%B5-%D0%B7%D0%B0%D0%BF%D0%BE%D0%BB%D0%BD%D1%8F%D0%B5%D1%82-%D1%81%D0%B5%D1%80%D0%B2%D0%B5%D1%80)). Полные значения видны при повторном чтении шаблона. Явно записанные поля сохраняются как есть. Заполненные значения совпадают со значениями такого же узла, созданного в редакторе, и со значениями на панели настроек исключений в редакторе. При выполнении используются заполненные значения.

| Поле | Подставляется, если не указано | Значения и семантика |
|  --- | --- | --- |
| policy | `"interrupt"` | interrupt: после сбоя узла запуск останавливается. skip: запись узла с ошибкой сохраняется, и выполнение продолжается. handle: сбой обрабатывается согласно handler, после чего выполнение продолжается или останавливается. Тайм-аут узла обрабатывается по policy так же, как любой другой сбой. Если исходная операция не завершилась и в течение ещё одного периода тайм-аута после его истечения, исполнитель сначала отключается и заново берёт под контроль то же окружение (сохраняя исходную текущую вкладку), а затем применяет policy. Если снова взять окружение под контроль не удалось (контекст выполнения изолирован) или запуск отменён, skip/handle не могут принудительно продолжить запуск. |
| handler | Не подставляется; исполнитель считает его равным `"screenshot"` | Действует, только если policy=handle и [ветви обработки исключений](#%D0%B2%D0%B5%D1%82%D0%B2%D0%B8-%D0%BE%D0%B1%D1%80%D0%B0%D0%B1%D0%BE%D1%82%D0%BA%D0%B8-%D0%B8%D1%81%D0%BA%D0%BB%D1%8E%D1%87%D0%B5%D0%BD%D0%B8%D0%B9) не используются. screenshot: продолжить после успешного снимка экрана или остановиться, если снимок не удался. stop: остановить оставшуюся часть сценария. remark: записать примечание окружения. |
| screenshot | `true` | Пытается сделать снимок экрана при окончательном сбое узла. Значение false отключает обычные снимки экрана при сбое, но при policy=handle и handler=screenshot снимок всё равно требуется. Снимок может оказаться невозможным, если страница закрыта, запуск отменён или контекст выполнения изолирован. Неудачный снимок не заменяет исходную ошибку узла. Локальные файловые узлы useExcel («Прочитать Excel»), exportExcel («Записать Excel»), importText («Импортировать текст») и saveData («Сохранить текст») никогда не делают снимков экрана, потому что их сбои не связаны со страницей браузера. Для этих узлов handler=screenshot только записывает ошибку, и выполнение продолжается. |
| timeout | `30000` для узлов действий; `0` (без ограничения) для управляющих узлов | Миллисекунды, **целое число** в диапазоне 0–2147483647 (как в редакторе; дробное значение возвращает RPA_WORKFLOW_SCHEMA_INVALID). `0` означает отсутствие ограничения времени. Это тайм-аут одного выполнения, и он также ограничен оставшимся временем всего запуска. Это не тайм-аут ожидания HTTP в Local API. Узел injectJavaScript дополнительно ограничен своим входным полем executionTimeoutMs. |
| retry | `false` | Включает повторы при сбое атомарного действия. |
| retryTimes | `1` | Действует при retry=true. Целое число в диапазоне 1–10, задающее число дополнительных попыток; действие выполняется не более 1+retryTimes раз. |
| retryInterval | `2` | Интервал между повторами в секундах, в диапазоне 0–2147483. Эта единица отличается от единицы timeout, который задаётся в миллисекундах. |


**Если timeout не указан, узлы действий (включая узлы навигации, например gotoUrl) получают 30 секунд, а управляющие узлы (loop, ifElse, breakLoop, applySubProcess, updateCustomVariable) получают `0`, то есть ограничения времени нет.** Управляющий узел без ограничения времени ограничен только оставшимся временем всего запуска, maxIterations цикла и отменой. Каждое дочернее действие внутри него по-прежнему выполняется со своим тайм-аутом (по умолчанию 30 секунд), поэтому отдельному действию на медленной странице нужен явно увеличенный тайм-аут. Тайм-аут, явно заданный для управляющего узла, охватывает весь вызов и все его дочерние узлы, и по истечении этого времени узел завершается ошибкой TIMEOUT.

Редактор клиента тоже записывает 0 (без ограничения) для новых управляющих узлов и 30000 для новых узлов действий. Любому узлу, которому не нужно ограничение времени, можно явно задать 0. Значение 2147483647, сохранённое более ранними версиями, по-прежнему допустимо и тоже означает отсутствие ограничения времени; при чтении оно не переписывается. Составляя сценарии, AI-агенты должны явно задавать exception исходя из бизнес-потребностей, а не полагаться на значения по умолчанию.

Повторы применяются к атомарным действиям. Управляющие узлы не используют эти настройки для повтора всего подграфа. После тайм-аута узла повтор тоже выполняется в соответствии с конфигурацией (при этом может повториться действие, которое уже сработало). Если исходная операция не завершилась и в течение ещё одного периода тайм-аута после его истечения, повтор выполняется только после того, как окружение снова взято под контроль. После отмены или неудачной попытки снова взять окружение под контроль автоматического повтора нет. Ни skip, ни успешный handle не делают узел с ошибкой успешным, поэтому hasNodeErrors всё равно нужно проверять.

Например, ниже показан цикл, который выполняется не более 10 минут, пропускает элемент со сбоем и продолжает работу, а также узел на медленной странице, который читает значение и при сбое дважды повторяет попытку:

```json
[
  {
    "id": "each_item",
    "type": "browser_loop",
    "data": {
      "browserAction": "loop",
      "browserUi": {
        "inputs": {
          "loopMode": "times",
          "times": 20,
          "accumulatorMode": "none"
        },
        "exception": {
          "policy": "interrupt",
          "timeout": 600000,
          "screenshot": true
        }
      }
    },
    "blocks": [
      {
        "id": "read_title",
        "type": "browser_getElement",
        "data": {
          "browserAction": "getElement",
          "browserUi": {
            "inputs": {
              "selectorType": "selector",
              "selectorRadio": "CSS",
              "selector": "h1",
              "type": "innerText"
            },
            "exception": {
              "policy": "skip",
              "timeout": 15000,
              "retry": true,
              "retryTimes": 2,
              "retryInterval": 1,
              "screenshot": true
            }
          }
        }
      }
    ]
  }
]
```

После успешной публикации снимка экрана `data.items` в ответе `GET /runs/{id}/artifacts` содержит метаданные этого артефакта, а `artifacts` записи о выполнении узла, который сделал снимок, ссылаются на тот же id. API не предоставляет URL для скачивания или содержимое файла. `path` содержит путь к снимку экрана на локальном компьютере.

### Ветви обработки исключений

Узел действия (включая управляющие действия, такие как applySubProcess, updateCustomVariable и breakLoop, но не ifElse и loop, у которых есть собственные blocks) может передать свой сбой двум ветвям на холсте: ветви успеха и ветви сбоя. Это работает так же, как настройка «Выполнить ветвь обработки исключений» в редакторе клиента. Порядок настройки:

- Задайте для `data.exception` значение `{"mode":"branchHandle"}` (на одном уровне с `data.browserUi`, а не внутри browserUi.exception).
- Задайте для `data.browserUi.exception.policy` значение `"handle"`.
- Сделайте так, чтобы `blocks` состояли ровно из двух узлов `exceptionBlock`: первый является ветвью успеха, второй ветвью сбоя. Роль определяется только порядком в массиве. Названия и ID могут быть любыми, а ветвь может не содержать узлов.


Семантика выполнения:

| Итоговый результат родительского узла | Поведение |
|  --- | --- |
| Успех (включая успех после повторов) | Выполняется только ветвь успеха, затем выполнение продолжается с узлов, следующих за родительским |
| Сбой (повторы исчерпаны) | Выполняется только ветвь сбоя, затем выполнение продолжается. Запись родительского узла остаётся в состоянии failed и сохраняет исходную ошибку и снимок экрана при сбое, с `nextAction=continue`; у запуска hasNodeErrors=true |
| Отмена, или исходная операция так и не завершилась после тайм-аута, а снова взять окружение под контроль не удалось (контекст выполнения изолирован) | Ветвь сбоя не выполняется; запуск завершается так же, как при других политиках |


- В режиме ветвей `handler` не действует (нет замещающего снимка экрана, примечания или остановки). Будет ли сделан снимок экрана при сбое, зависит только от `screenshot`.
- `data` родительского узла вычисляется в null по правилу для «узлов, после сбоя которых выполнение продолжается». Внутри ветви сбоя можно ссылаться на `${parentId.error.code}` и `${parentId.status}`.
- Две ветви взаимоисключающие. Узел в одной ветви не может ссылаться на узел в другой ветви (RPA_REFERENCE_NOT_VISIBLE), а на сам `exceptionBlock` ссылаться нельзя. Если узел после ветвей ссылается на узел внутри ветви, такой ссылке требуется проверка во время выполнения.
- Если узел внутри ветви завершается сбоем, сбой обрабатывается по его собственному exception, и ветвь сбоя родительского узла повторно не выполняется. Повтор родительского узла не воспроизводит ветви заново.
- При несоответствии структуры возвращается RPA_STRUCTURE_INVALID: задано mode=branchHandle, но blocks не состоят ровно из двух узлов exceptionBlock; policy не равно handle; настройка задана для ifElse/loop; или exceptionBlock находится не внутри такого узла.
- Значения `skipStep` / `stopTask` в `data.exception.mode` являются лишь пометкой редактора. Выполнение следует policy, и у узла не может быть дочерних узлов exceptionBlock.


```json
{
  "id": "open_shop",
  "type": "browser_newPage",
  "data": {
    "browserAction": "newPage",
    "browserUi": {
      "inputs": {"openMode": "url", "url": "https://example.com"},
      "exception": {"policy": "handle", "retry": true, "retryTimes": 2, "retryInterval": 2, "screenshot": true}
    },
    "exception": {"mode": "branchHandle"}
  },
  "blocks": [
    {"id": "open_ok", "type": "exceptionBlock", "data": {"title": "Success"}, "blocks": []},
    {"id": "open_failed", "type": "exceptionBlock", "data": {"title": "Failure"}, "blocks": [
      {"id": "wait_retry", "type": "browser_waitTime", "data": {"browserAction": "waitTime", "browserUi": {"inputs": {"timeoutType": "fixed", "timeout": 1000}}}}
    ]}
  ]
}
```

### Управляющие узлы, конечные состояния и этапы проверки

Управляющие узлы в публичном каталоге: browser_ifElse, browser_loop, browser_breakLoop, browser_applySubProcess и browser_updateCustomVariable (доступен ли узел, по-прежнему зависит от каталога экземпляра). Эти узлы принимают объект exception. Поле timeout ограничивает весь управляющий вызов и его дочерние вызовы; если оно не указано, оно равно 0 (без ограничения). Поля policy/handler/screenshot обрабатывают сбои управляющего вызова, включая ошибки, которые всплывают до этого вызова. Обычные управляющие сигналы break, end и stop не считаются сбоями, допускающими повтор. Поля retry/retryTimes/retryInterval всё равно должны проходить проверку полей, но во время выполнения управляющие узлы игнорируют повторы и не перезапускают весь подграф. Атомарные действия в дочерних узлах выполняются в соответствии с их собственным exception.

Узел с handler=remark можно сохранить, и он также может выполняться при внешнем запуске через Local API, так же как при запуске в клиенте.

Узлы, после сбоя которых выполнение продолжается: если узел выполнился, окончательно завершился сбоем, а выполнение продолжилось в соответствии с его exception (policy=skip или продолжение после handle), последующие ссылки на поля в его `data` вычисляются в `null`. Ссылка на значение целиком (например, `{type:'ref',content:['read','data','value']}` или вся строка `"${read.data.value}"`) получает `null`, а ссылка, встроенная в строку шаблона (например, `"Title: ${read.data.value}"`), получает пустую строку. Ссылки на пути вне data, например `${id.status}` и `${id.error}`, не меняются. Ссылка на несуществующий узел, на узел, который ещё не выполнялся, или на несуществующее поле успешного узла по-прежнему приводит к ошибке MISSING_VARIABLE во время выполнения. Правила статической проверки ссылок перед сохранением и запуском не меняются. Поэтому последующие узлы могут напрямую ссылаться на узел сбора данных, который может быть пропущен, без дополнительного узла переменной для «очистки/записи». В условии сравнение gt/gte/lt/lte с null считается невыполненным. Чтобы отличить «ничего не прочитано» от «прочитан 0», сначала проверьте exists.

В таблице ниже описан только результат по умолчанию после сбоя одного выполненного узла. Предполагается, что этот результат не переопределяется отменой, изоляцией контекста выполнения, последующим сбоем, неудачным вычислением выходных данных или явной инструкцией end:

| Политика | Следующее действие | run.status | hasNodeErrors |
|  --- | --- | --- | --- |
| interrupt | Прервать запуск | failed | true |
| skip | Перейти к следующим узлам | success (если все последующие узлы выполняются штатно) | true |
| handle + screenshot, снимок экрана сделан | Перейти к следующим узлам | success (если все последующие узлы выполняются штатно) | true |
| handle + screenshot, снимок экрана не удался | Прервать запуск | failed | true |
| handle + stop | Больше не выполнять узлы | stopped | true |


Это семантика выполнения, а не правила, позволяющие выводить результаты вместо того, чтобы их запрашивать. Отмена может привести к cancelled. Тайм-аут узла приводит к failed (TIMEOUT) и обрабатывается через retry/screenshot/policy. Если истекает время задачи или во время запуска закрывается браузер основного окружения, выполняющийся узел, как и запуск, завершается со статусом failed (RPA_TASK_TIMEOUT / ENVIRONMENT_CLOSED), и retry/policy не применяются. Если остановку не удаётся подтвердить, запуск завершается со статусом failed и error.code OUTCOME_UNKNOWN. В конце всегда читайте фактические run.status, hasNodeErrors и isolation.

JSON Schema для WorkflowException ограничивает только форму полей; правила для целых чисел и диапазонов применяет семантическая проверка. Даже если локальная проверка по схеме пройдена, всё равно нужно вызвать validations. Один вызов атомарного действия после исчерпания повторов пытается сделать не более одного снимка экрана при сбое. Несколько вызовов в цикле или отдельные сбои родительских и дочерних узлов могут дать несколько снимков экрана.

Полный пример привязки политики исключений к узлу (селектор `[` намеренно вызывает сбой во время выполнения, чтобы можно было увидеть обработку сбоя):

```json
{
  "id": "capture_failure",
  "type": "browser_getElement",
  "data": {
    "browserAction": "getElement",
    "browserUi": {
      "inputs": {
        "selector": "[",
        "selectorType": "selector",
        "outputRange": "single",
        "type": "innerText"
      },
      "exception": {
        "policy": "interrupt",
        "screenshot": true,
        "retry": false
      }
    }
  }
}
```

Где поля артефактов появляются в записях узлов и как запрашивать их постранично, см. на странице [Список выполнений узлов](/ru/browser-rpa/api/list-run-nodes). Структуру коллекции артефактов см. на странице [Список артефактов запуска](/ru/browser-rpa/api/list-run-artifacts).