# Спільні поля та структура сценарію

Шукайте типи вузлів через `GET /node-types?q=keyword&page=1&pageSize=20`, а потім передайте отриманий ідентифікатор типу в `GET /node-types/{nodeType}`. Сторінки нумеруються з 1, а розмір сторінки становить 1–100 (за замовчуванням 20). Тип, як-от `browser_gotoUrl`, відрізняється від ідентифікатора вузла в сценарії, як-от `visit`.

| Поле контракту | Що перевірити |
|  --- | --- |
| `authorable`, `runtimeSupported`, `externalRunnable`, `documentationComplete` | Створення сценаріїв, підтримка під час виконання, зовнішній запуск і повнота документації. |
| `inputSchema` | Типи, переліки, формати та структура. Розв'язуйте `$ref` за URL схеми екземпляра. |
| `conditionalRules`, `referenceRules` | Поля, обов'язкові або заборонені в кожному режимі, розв'язані значення та дозволена область посилань. |
| `defaults`, `outputVariants`, `fieldPolicies` | Значення за замовчуванням під час виконання, вихідні дані за режимами та політики полів. `x-editor-default` описує початкове значення в редакторі. |


## Структура сценарію

Указуйте `editorVersion: 2` і `editorParametersVersion: 1`. Кореневі `nodes` виконуються по черзі: першим іде один `start`, а останнім іде один `end`. Вкладені вузли використовують `blocks`, визначені контрактом кожного вузла. Ідентифікатори вузлів мають бути унікальними в межах усього дерева й не змінюватися під час редагування. Задайте кожному вузлу та кожній гілці описовий `data.title`. Група не може містити іншу групу.

Вузол дії використовує `type: browser_<action>`, відповідне значення `data.browserAction` і вхідні дані в `data.browserUi.inputs`. Вхідні дані дій використовують рядки на кшталт `${targetUrl}` і `${visit.data.finalUrl}`. Вихідні дані вузла «Кінець» і операнди умов можуть використовувати `{"type":"ref","content":["visit","data","finalUrl"]}` з масивом сегментів шляху. Посилайтеся лише на видимі змінні та попередні вузли. Оголошуйте власні змінні в `start.data.customVariables`, оновлюйте їх за допомогою `browser_updateCustomVariable` і читайте як `${custom.<id>}`. Після збереження працюйте з нормалізованим деревом, яке повернув сервер.

## Посилання на змінні

Якщо поле підтримує посилання на змінні, використовуйте `${…}` і замініть три крапки фактичною назвою змінної або шляхом посилання. Під час виконання сценарій розв'язує це посилання й перевіряє отримане значення за правилами поля.

Наприклад, `"selectorRadio": "${locatorType}"` читає початковий параметр `locatorType`. Значення `"XPath"` вибирає режим XPath. Розв'язане значення має бути `"CSS"` або `"XPath"`, тому `"TEXT"` не пройде перевірку.

## Приклади полів і обмежень

| Поле | Правило |
|  --- | --- |
| `gotoUrl.url` | Обов'язковий рядок; підтримує посилання. Для переносних шаблонів використовуйте абсолютний URL HTTP(S). Для інших схем виконайте попередню перевірку у своєму клієнті та перевірте, як браузер їх обробляє. |
| `gotoUrl.postWaitMs` | Число або підтримуваний числовий вираз із задокументованим діапазоном 0–2147483647 мілісекунд після розв'язання. Значення за замовчуванням становить 1000; щоб вимкнути очікування, укажіть 0. Не виходьте за межі цього діапазону. |
| `getUrl.type` / `key` | `href` (за замовчуванням), `origin` або `search`. Режим search потребує ключа, який розв'язується в непорожній рядок. У режимі href `data.value` містить повний поточний URL. Як обробляються відсутні значення search, перевіряйте в актуальному контракті. |
| `browserUi.exception.timeout` | Ціле число, 0–2147483647 мілісекунд. Нуль вимикає тайм-аут вузла, але бюджет часу запуску все одно діє. За замовчуванням використовується 30000 для дій і 0 для вузлів керування. Явно заданий тайм-аут вузла керування охоплює весь його дочірній граф. |
| `browserUi.exception.policy` | Явно задайте `interrupt`, `skip` або `handle`. Якщо невдалий вузол пропущено, посилання на його дані розв'язуються в null; перевіряйте `hasNodeErrors` запуску. |
| `retryTimes` / `retryInterval` | Якщо для атомарної дії ввімкнено повтор, допускається 1–10 додаткових спроб. Інтервал становить 0–2147483 **секунд**. Повторна спроба може ще раз виконати дію, яка вже спрацювала. |


Шаблон потребує полів `title` (1–100 символів після обрізання пробілів), `description` (до 1000 символів, може бути порожнім), `workflow` і `dependencies` (якщо дочірніх шаблонів немає, використовуйте `[]`). Ліміти розміру запиту й сценарію, кількості вузлів, глибини вкладеності та кількості змін на запит дивіться в `capabilities.data.limits`. Повні моделі описано на сторінках [Сценарій, змінні та структурні вузли](/uk/browser-rpa/api/workflow) і [Моделі даних](/uk/browser-rpa/api/data-types).

Далі: [перевірте та збережіть приклад](/uk/browser-rpa/quickstart).