# Надіслати вкладення

Тип вузла `browser_uploadAttachment`

## Призначення

Додає локальний файл до поля вибору файлу на сторінці.

## Налаштування в настільному клієнті

![Налаштування вузла «Надіслати вкладення» в настільному клієнті](/assets/upload-attachment.673ab54ee9f6f9ad9fdba664068f9710fec6296c2fad2088b0a6598848742ea7.0538f3a9.webp)

Знімок екрана зроблено в англійському інтерфейсі MoreLogin Desktop V2.73.101.

## Вхідні дані

Ці поля розміщуються в `data.browserUi.inputs`.

| Поле | Тип або значення | Обов'язкове за схемою | Значення за замовчуванням під час виконання | Опис і обмеження |
|  --- | --- | --- | --- | --- |
| `selectorType` | `"selector"` / `"element"` / `"frame"` (підтримує посилання на змінні) | Ні | `"selector"` | Джерело елемента. Початкове значення в редакторі: `"selector"` |
| `frame` | `string` | Ні | — | Змінна iframe |
| `element` | `string` | Ні | — | Змінна елемента |
| `selectorRadio` | `"CSS"` / `"XPath"` (підтримує посилання на змінні) | Ні | `"CSS"` | Тип селектора. Початкове значення в редакторі: `"CSS"` |
| `selector` | `string` | Ні | — | Селектор |
| `serialType` | `"fixed"` / `"randomInterval"` (підтримує посилання на змінні) | Ні | `"fixed"` | Якщо збігається кілька об'єктів елементів. Початкове значення в редакторі: `"fixed"` |
| `serial` | `WorkflowNumber` | Ні | `1` | Індекс елемента; ціле число; мінімум після розв'язання: 1. Початкове значення в редакторі: `1` |
| `serialMin` | `WorkflowNumber` | Ні | — | Мінімальний індекс; ціле число; мінімум після розв'язання: 1 |
| `serialMax` | `WorkflowNumber` | Ні | — | Максимальний індекс; ціле число; мінімум після розв'язання: 1 |
| `type` | `"local"` / `"folder"` / `"network"` (підтримує посилання на змінні) | Ні | `"local"` | Джерело вкладення. Початкове значення в редакторі: `"local"` |
| `url` | `string` | Ні | — | Шлях до вкладення / URL |
| `postWaitMs` | `WorkflowNumber` | Ні | `1000` | Очікування після завершення (мс); мінімум після розв'язання: 0. Початкове значення в редакторі: `1000` |
| `downloadTimeoutMs` | `WorkflowNumber` | Ні | `10000` | Тайм-аут завантаження мережевого файлу (мс); мінімум після розв'язання: 100. Початкове значення в редакторі: `10000` |


## Вимоги до режимів і обмеження

- **Правила пошуку елемента:** selectorType=selector потребує selector; frame потребує frame+selector; element потребує посилання ElementRef з попереднього вузла. serial починається з 1. randomInterval використовує serialMin/serialMax, і мінімум не може бути більшим за максимум. Вузол спочатку чекає, доки селектор знайде відповідні елементи, а потім один раз вибирає індекс: верхня межа діапазону обмежується фактичною кількістю збігів. Якщо фіксований індекс або нижня межа діапазону перевищує кількість збігів, одразу повертається ELEMENT_NOT_FOUND (reason=range, details.field має значення serial або serialMin), а зі сторінкою не виконується жодних дій.
Для local/folder/network url є відповідно дозволеним шляхом до файлу, шляхом до каталогу або URL HTTP/HTTPS і є обов'язковим для виконання. Для мережевих вкладень діє окремий downloadTimeoutMs, за замовчуванням 10000 мс. Якщо завантаження не вдається, повертається NETWORK_DOWNLOAD_FAILED, і надсилання зупиняється.
- Код помилки перевірки: `RPA_NODE_INPUT_INVALID`


## Посилання у вхідних даних

| Поле | Дозволені форми |
|  --- | --- |
| `selectorType` | `literal`, `template` |
| `frame` | `literal`, `template` |
| `element` | `literal`, `template` |
| `selectorRadio` | `literal`, `template` |
| `selector` | `literal`, `template` |
| `serialType` | `literal`, `template` |
| `serial` | `literal`, `numericExpression` |
| `serialMin` | `literal`, `numericExpression` |
| `serialMax` | `literal`, `numericExpression` |
| `type` | `literal`, `template` |
| `url` | `literal`, `template` |
| `postWaitMs` | `literal`, `numericExpression` |
| `downloadTimeoutMs` | `literal`, `numericExpression` |


## Вихідні дані

| Поле вихідних даних | Тип або значення |
|  --- | --- |
| `element` | `ElementRef` |
| `files` | array<`object`> |
| `fileCount` | `number` |


Посилайтеся на опубліковані поля у форматі `${nodeId.data.field}`.

## Приклад JSON

Повний об'єкт вузла для масиву `nodes` сценарію або для `blocks` іншого вузла. Замініть локальні шляхи на абсолютні шляхи на своєму комп'ютері.

```json
{
  "id": "upload_photo",
  "type": "browser_uploadAttachment",
  "data": {
    "title": "Upload the product photo",
    "browserAction": "uploadAttachment",
    "browserUi": {
      "inputs": {
        "selectorType": "selector",
        "selectorRadio": "CSS",
        "selector": "input[type=file]",
        "type": "local",
        "url": "/Users/example/Pictures/product.jpg",
        "postWaitMs": 1000
      },
      "exception": {
        "timeout": 30000,
        "policy": "interrupt"
      }
    }
  }
}
```

[Назад до каталогу вузлів](/uk/browser-rpa/nodes)