# 存到 Excel

节点类型 `browser_exportExcel`

## 功能说明

将流程数据写入本机 Excel 工作簿。

## 客户端配置界面

![存到 Excel节点的客户端配置界面](/assets/export-excel.78d01182850a67a30a21157ec49f453f5d8a5a6a7a0f0f713eda4b5e031b657d.0538f3a9.webp)

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

## 输入字段

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

| 字段 | 类型或取值 | Schema 必填 | 执行默认值 | 说明与边界 |
|  --- | --- | --- | --- | --- |
| `path` | `string` | 否 | — | 文件路径 |
| `existingFile` | `"append"` / `"overwrite"`（支持变量引用） | 否 | `"append"` | 文件已存在时 编辑器初值 `"append"` |
| `writeMode` | `"columns"` / `"object"`（支持变量引用） | 否 | `"columns"` | 写入方式 编辑器初值 `"columns"` |
| `fields` | array<`object`>（支持变量引用） | 否 | — | 写入数据 |
| `rowObject` | `["null","boolean","number","string"]` / array<`JSON`> / `object`（支持变量引用） | 否 | — | 行数据对象 |


## 条件与边界

- path 为 .xlsx/.xls 绝对文件名；writeMode=columns 要求非空 fields:[{key,value}] 且 key 唯一；object 要求非空 rowObject。existingFile 控制原路径追加或覆盖。
- 校验错误码 `RPA_NODE_INPUT_INVALID`


## 输入引用

| 字段 | 允许的形式 |
|  --- | --- |
| `path` | `literal`, `template` |
| `existingFile` | `literal`, `template` |
| `writeMode` | `literal`, `template` |
| `fields` | `literal`, `template` |
| `rowObject` | `literal`, `template` |


## 输出字段

| 输出字段 | 类型或取值 |
|  --- | --- |
| `path` | `string` |
| `name` | `string` |
| `rowCount` | `number` |
| `totalRowCount` | `number` |
| `columns` | array<`string`> |
| `row` | `object` |
| `writeAction` | `"append"` / `"overwrite"` |
| `pending` | `false` |


按契约用 `${nodeId.data.field}` 引用公开字段。

## JSON 示例

可放入流程 `nodes` 数组或其他节点 `blocks` 中的完整节点对象。示例读取前面「元素数据」节点的输出 `read_title.data.text`。把本机路径换成你电脑上的绝对路径。

```json
{
  "id": "write_result",
  "type": "browser_exportExcel",
  "data": {
    "title": "将结果写入表格",
    "browserAction": "exportExcel",
    "browserUi": {
      "inputs": {
        "path": "/Users/example/Documents/results.xlsx",
        "existingFile": "append",
        "writeMode": "columns",
        "fields": [
          {
            "key": "Heading",
            "value": "${read_title.data.text}"
          },
          {
            "key": "Status",
            "value": "done"
          }
        ]
      },
      "exception": {
        "timeout": 30000,
        "policy": "interrupt"
      }
    }
  }
}
```

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