{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/ru/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Общие поля и структура сценария"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"общие-поля-и-структура-сценария","__idx":0},"children":["Общие поля и структура сценария"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Выполните поиск через ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /node-types?q=keyword&page=1&pageSize=20"]},", затем передайте полученный ID типа в ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /node-types/{nodeType}"]},". Нумерация страниц начинается с 1, размер страницы составляет 1–100 (по умолчанию 20). Тип, например ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["browser_gotoUrl"]},", отличается от ID узла в сценарии, например ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["visit"]},"."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Поле контракта"},"children":["Поле контракта"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Что проверить"},"children":["Что проверить"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["authorable"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["runtimeSupported"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["externalRunnable"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["documentationComplete"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Возможность использования в шаблонах, поддержка во время выполнения, внешний запуск и полнота документации."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["inputSchema"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Типы, перечисления, форматы и структура. Разрешайте ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["$ref"]}," по URL схемы текущего экземпляра."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["conditionalRules"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["referenceRules"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Поля, обязательные или запрещённые в каждом режиме, вычисленные значения и допустимая область ссылок."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["defaults"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["outputVariants"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fieldPolicies"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Значения по умолчанию при выполнении, выходные данные по режимам и политики полей. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["x-editor-default"]}," описывает начальное значение в редакторе."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"структура-сценария","__idx":1},"children":["Структура сценария"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Указывайте ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["editorVersion: 2"]}," и ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["editorParametersVersion: 1"]},". Корневые ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["nodes"]}," выполняются по порядку: первым идёт один ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["start"]},", последним идёт один ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["end"]},". Вложенные узлы используют ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["blocks"]},", заданные контрактом каждого узла. ID узлов должны быть уникальными во всём дереве и не меняться при правках. Дайте каждому узлу и ветви содержательный ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data.title"]},". Группа не может содержать другую группу."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Узел действия использует ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type: browser_<action>"]},", соответствующий ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data.browserAction"]}," и входные данные в ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data.browserUi.inputs"]},". Входные данные действий задаются строками вида ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["${targetUrl}"]}," и ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["${visit.data.finalUrl}"]},". Выходные данные узла «Конец» и операнды условий могут использовать ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{\"type\":\"ref\",\"content\":[\"visit\",\"data\",\"finalUrl\"]}"]}," с массивом сегментов пути. Ссылайтесь только на видимые переменные и предыдущие узлы. Объявляйте пользовательские переменные в ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["start.data.customVariables"]},", обновляйте их с помощью ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["browser_updateCustomVariable"]}," и читайте как ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["${custom.<id>}"]},". После сохранения работайте с нормализованным деревом, которое вернул сервер."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"ссылки-на-переменные","__idx":2},"children":["Ссылки на переменные"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Если поле поддерживает ссылки на переменные, используйте ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["${…}"]}," и замените многоточие фактическим именем переменной или путём ссылки. Сценарий разрешает эту ссылку во время выполнения и проверяет полученное значение по правилам поля."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Например, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"selectorRadio\": \"${locatorType}\""]}," читает начальный параметр ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["locatorType"]},". Значение ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"XPath\""]}," выбирает режим XPath. Вычисленное значение должно быть ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"CSS\""]}," или ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"XPath\""]},", поэтому ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"TEXT\""]}," не проходит проверку."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"примеры-полей-и-ограничений","__idx":3},"children":["Примеры полей и ограничений"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Поле"},"children":["Поле"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Правило"},"children":["Правило"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["gotoUrl.url"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Обязательная строка; поддерживает ссылки. Для переносимых шаблонов используйте абсолютный URL HTTP(S). Для других схем выполните предварительную проверку на своём клиенте и проверьте, как браузер их обрабатывает."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["gotoUrl.postWaitMs"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Число или поддерживаемое числовое выражение; задокументированный диапазон после вычисления составляет 0–2147483647 миллисекунд. По умолчанию 1000; чтобы не ждать, укажите 0. Не выходите за пределы этого диапазона."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["getUrl.type"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["key"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["href"]}," (по умолчанию), ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["origin"]}," или ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["search"]},". Для search нужен ключ, значение которого вычисляется в непустую строку. В режиме href ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data.value"]}," содержит полный текущий URL. Как обрабатываются отсутствующие значения search, уточняйте в актуальном контракте."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["browserUi.exception.timeout"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Целое число, 0–2147483647 миллисекунд. Ноль отключает тайм-аут узла, но бюджет времени запуска продолжает действовать. По умолчанию: 30000 для действий и 0 для управляющих узлов. Явно заданный тайм-аут управляющего узла распространяется на весь его дочерний граф."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["browserUi.exception.policy"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Явно укажите ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["interrupt"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["skip"]}," или ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["handle"]},". Если узел с ошибкой пропущен, ссылки на его данные вычисляются в null; проверяйте ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hasNodeErrors"]}," запуска."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["retryTimes"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["retryInterval"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Если для атомарного действия включён повтор, допускается 1–10 дополнительных попыток. Интервал составляет 0–2147483 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["секунд"]},". Повтор может заново выполнить действие, которое уже сработало."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Шаблону нужны ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["title"]}," (1–100 символов после удаления пробелов по краям), ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["description"]}," (до 1000 символов, может быть пустым), ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["workflow"]}," и ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dependencies"]}," (если дочерних шаблонов нет, укажите ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["[]"]},"). Ограничения на размер запроса и сценария, число узлов, глубину вложенности и число правок в одном запросе смотрите в ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["capabilities.data.limits"]},". Полные модели описаны на страницах ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/browser-rpa/api/workflow"},"children":["Сценарий, переменные и структурные узлы"]}," и ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/browser-rpa/api/data-types"},"children":["Модели данных"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Далее: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/browser-rpa/quickstart"},"children":["проверьте и сохраните пример"]},"."]}]},"headings":[{"value":"Общие поля и структура сценария","id":"общие-поля-и-структура-сценария","depth":1},{"value":"Структура сценария","id":"структура-сценария","depth":2},{"value":"Ссылки на переменные","id":"ссылки-на-переменные","depth":2},{"value":"Примеры полей и ограничений","id":"примеры-полей-и-ограничений","depth":2}],"frontmatter":{"seo":{"title":"Общие поля и структура сценария"}},"lastModified":"2026-11-20T14:40:39.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/ru/browser-rpa/node-contract-guide","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}