# 上传附件

节点类型 `browser_uploadAttachment`

## 功能说明

将本机文件交给网页文件输入控件。

## 客户端配置界面

![上传附件节点的客户端配置界面](/assets/upload-attachment.673ab54ee9f6f9ad9fdba664068f9710fec6296c2fad2088b0a6598848742ea7.0538f3a9.webp)

截图来自 MoreLogin 桌面客户端 V2.73.101 的英文界面。

## 输入字段

以下字段位于 `data.browserUi.inputs`。

| 字段 | 类型或取值 | Schema 必填 | 执行默认值 | 说明与边界 |
|  --- | --- | --- | --- | --- |
| `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` | 元素序号; integer; minimum after resolution: 1 编辑器初值 `1` |
| `serialMin` | `WorkflowNumber` | 否 | — | 最小序号; integer; minimum after resolution: 1 |
| `serialMax` | `WorkflowNumber` | 否 | — | 最大序号; integer; minimum after resolution: 1 |
| `type` | `"local"` / `"folder"` / `"network"`（支持变量引用） | 否 | `"local"` | 附件来源 编辑器初值 `"local"` |
| `url` | `string` | 否 | — | 附件路径 / URL |
| `postWaitMs` | `WorkflowNumber` | 否 | `1000` | 完成后等待时长（毫秒）; minimum after resolution: 0 编辑器初值 `1000` |
| `downloadTimeoutMs` | `WorkflowNumber` | 否 | `10000` | 网络文件下载超时（毫秒）; minimum after resolution: 100 编辑器初值 `10000` |


## 条件与边界

- **定位规则：** selectorType=selector 要求 selector；frame 要求 frame+selector；element 要求前序 ElementRef 引用。serial 从 1 开始；randomInterval 使用 serialMin/serialMax，最小值不能大于最大值；先等待选择器匹配到元素，再一次性取序号：区间上限按实际匹配数截断；固定序号或区间下限大于匹配数时立即返回 ELEMENT_NOT_FOUND（reason=range，details.field 为 serial 或 serialMin），不操作页面。
url 在 local/folder/network 分别是已授权文件路径、目录路径、HTTP/HTTPS URL，执行必需。 网络附件独立 downloadTimeoutMs 默认10000ms；下载失败返回 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": "上传商品图片",
    "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"
      }
    }
  }
}
```

[返回节点目录](/zh/browser-rpa/nodes)