# リストを結合

> 複数のリストを 1 つにまとめます。「連結」は接続した順番にリストをつなげ、「Zip」は同じ位置の項目どうしを結合します。結合後に重複を削除することもできます。

Source: https://nodaro.ai/ja/docs/nodes/automate/merge-lists

**リストを結合**（Merge Lists）ノードは、複数のリストを 1 つにまとめます。**連結**は、接続した順番にリストを次々とつなげます。**Zip（項目ごとに結合）**は、同じ位置にある項目どうしを 1 つの項目に結合します。Zip を使うと、共通のオブジェクトを 1 つ、長いリストのすべての項目に追加できます。オプションのスイッチをオンにすると、結合の後に重複が削除されます。このノードは無料です。

- Found in: Automate › Lists & Batching
- Output: data
- API type: `merge-lists`

## 使いどころ
- 2 回のスクレイピングの結果を、1 つのリストにまとめます。
- 2 つの取得元から集めたプロンプトを、1 つのバッチにまとめます。
- ブランドの詳細など、同じ設定のオブジェクトを、商品リストのすべての項目に追加します。

## クイックスタート
### ノードを追加する
キャンバス上で Tab を押し、**自動化 › リストとバッチ処理 › リストを結合**を選びます。

### 2 つ以上のリストを接続する
それぞれのリストを**リスト**入力に接続します。**連結**では、最初に接続したリストの項目が先頭に来ます。

### モードを選ぶ
設定パネルを開き、**連結**か **Zip（項目ごとに結合）**を選びます。重複を取り除くには、**結合後に重複を削除**をオンにします。

### 実行する
**結合済み**出力が、まとめたリストを渡します。実行後は、パネルに先頭の項目のプレビューと、項目の数が表示されます。

Workflow: リストに入力したプロンプトと、脚本から分割したプロンプトが 1 つのバッチになり、画像生成がプロンプトごとに 1 回ずつ実行されます。

- リスト → リストを結合 (リスト)
- テキストを分割 → リストを結合 (リスト)
- リストを結合 → 画像生成 (プロンプト · 個別)

## 入力と出力
| 入力／出力 | 受け取るもの／送るもの | 説明 |
| --- | --- | --- |
| **リスト** | 2 つ以上のリスト | 結合するリストです。単一の値を送るノードは、項目が 1 つのリストとして扱われます。 |
| **結合済み** | リスト | 結合されたリストです。 |

## 設定
| 設定 | 説明 |
| --- | --- |
| **モード** | デフォルトの**連結**は、接続の順番にリストをつなげます。**Zip（項目ごとに結合）**は、同じ位置にある項目どうしを結合します。Zip モードでは、短いリストは最初の項目から繰り返し使われ、単一のオブジェクトは長いリストのすべての項目に結合されます。 |
| **結合後に重複を削除** | デフォルトは**オフ**です。**オン**にすると、結合の後で、値を比較して重複する項目を取り除きます。 |

## Zip で項目を結合する仕組み
Zip は、JSON オブジェクトのリストのためのモードです。商品リストと 1 つの共通オブジェクトを結合すると、すべての商品に共通のフィールドが追加されます。

| 接続 | 値 |
| --- | --- |
| 1 つ目のリスト | `[{ "name": "Mug" }, { "name": "Cap" }]` |
| 2 つ目の接続 | `{ "brand": "Nodaro" }` |
| **結合済み**出力 | `[{ "name": "Mug", "brand": "Nodaro" }, { "name": "Cap", "brand": "Nodaro" }]` |

## クレジット
リストを結合ノードは無料です。

## ヒント
- **使いたい順番に接続する**：連結は接続の順番に従います。そのため、先頭に置きたいリストを、ほかのリストより先に接続します。
- **フィールドで比較する**：**結合後に重複を削除**は、項目全体を比較します。同じ `id` を持つ項目を重複として扱うには、リストを結合の後に[**重複を削除**（Remove Duplicates）](https://nodaro.ai/docs/nodes/automate/remove-duplicates)ノードをつなぎます。
- **単一の結果を集める**：リストではなく、複数のノードの単一の結果を集めるには、[**収集**（Collect）](https://nodaro.ai/docs/nodes/automate/collect)を使います。

## Frequently asked questions

### 「リストを結合」の「連結」と「Zip」の違いは何ですか？

「連結」は、接続した順番にリストを次々とつなげます。「Zip」は、同じ位置にある項目どうしを 1 つの項目に結合します。そのため、5 項目のリストを 2 つ結合すると、結合された 5 つの項目になります。

### Zip モードで、リストの長さが異なる場合はどうなりますか？

短いリストは、最も長いリストが終わるまで、最初の項目から繰り返し使われます。1 つの接続から届いた単一のオブジェクトは、長いリストのすべての項目に結合されます。

### 「リストを結合」で重複を削除できますか？

はい。「結合後に重複を削除」をオンにすると、リストを結合した後で、値が同じ項目が取り除かれます。デフォルトではオフです。

### 「リストを結合」にクレジットはかかりますか？

いいえ。「リストを結合」は無料です。