# Excel に書き込む

ノードタイプ `browser_exportExcel`

## 機能

ワークフローのデータをローカルの Excel ブックに書き込みます。

## デスクトップクライアントでの設定

![デスクトップクライアントでの「Excel に書き込む」の設定](/assets/export-excel.78d01182850a67a30a21157ec49f453f5d8a5a6a7a0f0f713eda4b5e031b657d.0538f3a9.webp)

MoreLogin デスクトップクライアント V2.73.101 の英語インターフェースで撮影しました。

## 入力

これらのフィールドは `data.browserUi.inputs` に置きます。

| フィールド | 型または値 | スキーマで必須 | 実行時の既定値 | 説明と制約 |
|  --- | --- | --- | --- | --- |
| `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": "Write the result to a spreadsheet",
    "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"
      }
    }
  }
}
```

[ノードカタログに戻る](/ja/browser-rpa/nodes)