# JSON を処理

ノードタイプ `browser_processJson`

## 機能

設定した JSON の処理モードを使って、データを変換または選択します。

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

![デスクトップクライアントでの「JSON を処理」の設定](/assets/process-json.6564eabc63274e2bf8307d635ed723d3237508b184da8a16d550a1888edd4097.0538f3a9.webp)

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

## 入力

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

| フィールド | 型または値 | スキーマで必須 | 実行時の既定値 | 説明と制約 |
|  --- | --- | --- | --- | --- |
| `source` | `["null","boolean","number","string"]` / array<`JSON`> / `object`（変数参照をサポート） | いいえ | — | 入力 JSON |
| `dataType` | `["null","boolean","number","string"]` / array<`JSON`> / `object`（変数参照をサポート） | いいえ | — | データ型 |
| `processingMode` | `"display"` / `"organize"` / `"combine"`（変数参照をサポート） | はい | — | 処理モード |
| `mergeSources` | `["null","boolean","number","string"]` / array<`JSON`> / `object`（変数参照をサポート） | いいえ | — | マージするデータ。エディターの初期値：`["",""]` |
| `fieldMappings` | array<`object`>（変数参照をサポート） | いいえ | — | 対象フィールド。エディターの初期値：`[{"key":"","from":"field","path":"","value":""}]` |
| `conflictPolicy` | `"first"` / `"last"` / `string` / `null` | いいえ | — | 同名フィールドの処理 |
| `showList` | `boolean`（変数参照をサポート） | いいえ | `true` | リストを表示。エディターの初期値：`true` |
| `singleResult` | `"first"` / `"random"`（変数参照をサポート） | いいえ | `"first"` | 結果の選択。エディターの初期値：`"first"` |
| `dedupeEnabled` | `boolean`（変数参照をサポート） | いいえ | `false` | 重複を除去。エディターの初期値：`false` |
| `dedupeBy` | `"whole"` / `"field"`（変数参照をサポート） | いいえ | `"whole"` | 重複除去の方法。エディターの初期値：`"whole"` |
| `outputDedupeField` | `string` | いいえ | — | 重複除去に使うフィールドのパス |
| `sortEnabled` | `boolean`（変数参照をサポート） | いいえ | `false` | 並べ替え。エディターの初期値：`false` |
| `sortBy` | `"field"`（変数参照をサポート） | いいえ | `"field"` | 並べ替えの基準。エディターの初期値：`"field"` |
| `outputSortField` | `string` | いいえ | — | 並べ替えに使うフィールドのパス |
| `sortDirection` | `"asc"` / `"desc"` / `string` / `null` | いいえ | — | 並べ替えの方向 |
| `resultPreview` | `["null","boolean","number","string"]` / array<`JSON`> / `object`（変数参照をサポート） | いいえ | — | 結果のプレビュー |


## モードごとの要件と制限

- processingMode（必須、既定値なし）= display/organize/combine：fieldMappings は、対象フィールドとソースパスに従ってデータを再構成します。mergeSources は同じ型のオブジェクト/配列をマージし、conflictPolicy は同名フィールドのポリシーを設定します。リストは重複除去と並べ替えができ、最初の項目またはランダムな項目を選択できます。JSON 内の参照は型を維持し、正しくエスケープされます。存在しない JSON の参照は、空文字列に置き換えられます。
- 検証コード：`RPA_NODE_INPUT_INVALID`
- 必須：`processingMode`
- このフィールドはエディターでは必須で、既定値はありません。省略すると、書き込みと検証では RPA_NODE_INPUT_INVALID（reason=required）が返され、実行も開始前に同じように拒否されます。
- 検証コード：`RPA_NODE_INPUT_INVALID`


## 入力の参照

| フィールド | 許可される形式 |
|  --- | --- |
| `source` | `literal`, `template` |
| `dataType` | `literal`, `template` |
| `processingMode` | `literal`, `template` |
| `mergeSources` | `literal`, `template` |
| `fieldMappings` | `literal`, `template` |
| `conflictPolicy` | `literal`, `template` |
| `showList` | `literal`, `template` |
| `singleResult` | `literal`, `template` |
| `dedupeEnabled` | `literal`, `template` |
| `dedupeBy` | `literal`, `template` |
| `outputDedupeField` | `literal`, `template` |
| `sortEnabled` | `literal`, `template` |
| `sortBy` | `literal`, `template` |
| `outputSortField` | `literal`, `template` |
| `sortDirection` | `literal`, `template` |
| `resultPreview` | `literal`, `template` |


## 出力

| 出力フィールド | 型または値 |
|  --- | --- |
| `value` | `["null","boolean","number","string"]` / array<`JSON`> / `object` |
| `count` | `number` |
| `index` | `number` |


公開されているフィールドは、`${nodeId.data.field}` として参照します。

## JSON の例

ワークフローの `nodes` 配列、または別のノードの `blocks` に入れる完全なノードオブジェクトです。

```json
{
  "id": "pick_names",
  "type": "browser_processJson",
  "data": {
    "title": "Keep the product name and add a currency",
    "browserAction": "processJson",
    "browserUi": {
      "inputs": {
        "source": [
          {
            "name": "Desk",
            "price": 120
          },
          {
            "name": "Chair",
            "price": 45
          }
        ],
        "processingMode": "organize",
        "fieldMappings": [
          {
            "key": "product",
            "from": "field",
            "path": "name"
          },
          {
            "key": "currency",
            "from": "fixed",
            "value": "USD"
          }
        ]
      },
      "exception": {
        "timeout": 30000,
        "policy": "interrupt"
      }
    }
  }
}
```

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