# Mesclar listas

> Combine várias listas em uma. Concatenar as junta na ordem das conexões, e Emparelhar mescla os itens da mesma posição. Descartar duplicatas é opcional.

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

O nó **Mesclar listas** (Merge Lists) combina várias listas em uma. **Concatenar** junta as listas uma depois da outra, na ordem em que você as conectou. **Emparelhar (mesclar itens)** mescla em um só item os itens que ocupam a mesma posição. Com o Emparelhar, você pode adicionar um objeto compartilhado a cada item de uma lista mais longa. Uma opção remove as duplicatas depois da mesclagem. O nó é gratuito.

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

## Quando usar
- Juntar os resultados de duas extrações em uma lista.
- Combinar prompts de duas origens em um só lote.
- Adicionar o mesmo objeto de configurações, como os dados da marca, a cada item de uma lista de produtos.

## Início rápido
### Adicionar o nó
Pressione Tab no canvas e escolha **Automatizar › Listas e lotes › Mesclar listas**.

### Conectar duas ou mais listas
Conecte cada lista à entrada **Listas**. Com **Concatenar**, os itens da primeira conexão vêm primeiro.

### Escolher um modo
Abra o painel de configurações e escolha **Concatenar** ou **Emparelhar (mesclar itens)**. Ative **Remover duplicatas após mesclar** para descartar as repetições.

### Executar
A saída **Mesclados** leva a lista combinada. Depois de uma execução, o painel mostra uma prévia dos primeiros itens e quantos eles são.

Workflow: Prompts digitados em uma Lista e prompts tirados de um roteiro viram um só lote, e o Gerar imagem é executado uma vez por prompt.

- Lista → Mesclar listas (listas)
- Dividir texto → Mesclar listas (listas)
- Mesclar listas → Gerar imagem (prompt · Cada item)

## Entradas e saídas
| Entrada ou saída | Aceita ou envia | O que faz |
| --- | --- | --- |
| **Listas** | Duas ou mais listas | As listas a combinar. Um nó que envia um único valor conta como uma lista com um item. |
| **Mesclados** | Uma lista | A lista combinada. |

## Configurações
| Configuração | O que faz |
| --- | --- |
| **Modo** | **Concatenar**, o padrão, junta as listas na ordem das conexões. **Emparelhar (mesclar itens)** mescla os itens que ocupam a mesma posição. No modo Emparelhar, as listas mais curtas recomeçam do primeiro item, e um único objeto é mesclado em cada item da lista mais longa. |
| **Remover duplicatas após mesclar** | **Desativado** por padrão. **Ativado** descarta os itens repetidos, comparados pelo valor, depois da mesclagem. |

## Como o Emparelhar mescla os itens
O Emparelhar foi feito para listas de objetos JSON. Com uma lista de produtos e um objeto compartilhado, cada produto recebe os campos compartilhados.

| Conexão | Valor |
| --- | --- |
| Primeira lista | `[{ "name": "Mug" }, { "name": "Cap" }]` |
| Segunda conexão | `{ "brand": "Nodaro" }` |
| Saída **Mesclados** | `[{ "name": "Mug", "brand": "Nodaro" }, { "name": "Cap", "brand": "Nodaro" }]` |

## Créditos
O Mesclar listas é gratuito.

## Dicas
- **Conecte na ordem que você quer.** O Concatenar segue a ordem das conexões, então conecte primeiro a lista que deve vir primeiro.
- **Compare por um campo.** **Remover duplicatas após mesclar** compara os itens inteiros. Para tratar como duplicatas os itens com o mesmo `id`, coloque um [**Remover duplicatas** (Remove Duplicates)](https://nodaro.ai/docs/nodes/automate/remove-duplicates) depois do Mesclar listas.
- **Reúna resultados avulsos.** Para reunir resultados avulsos de vários nós, em vez de listas, use o [**Coletar** (Collect)](https://nodaro.ai/docs/nodes/automate/collect).

## Frequently asked questions

### Qual é a diferença entre “Concatenar” e “Emparelhar” no “Mesclar listas”?

“Concatenar” junta as listas uma depois da outra, na ordem em que você as conectou. “Emparelhar” mescla em um só item os itens que ocupam a mesma posição, então duas listas de 5 itens geram 5 itens mesclados.

### O que acontece no modo “Emparelhar” quando as listas têm tamanhos diferentes?

As listas mais curtas recomeçam do primeiro item até a lista mais longa acabar. Um único objeto vindo de uma conexão é mesclado em cada item da lista mais longa.

### O “Mesclar listas” consegue remover duplicatas?

Sim. Ative “Remover duplicatas após mesclar” para descartar os itens repetidos pelo valor depois que as listas forem mescladas. A opção vem desativada por padrão.

### O “Mesclar listas” custa créditos?

Não. O “Mesclar listas” é gratuito.