Visão Geral

Este artigo explica como configurar o conector Ligaí - Agrupador de Listas, na ação Concatena duas listas. Esta ferramenta utilitária é fundamental para manipular dados dentro do fluxo do robô, permitindo unir dois conjuntos de dados (arrays) em uma única lista, podendo utilizar uma chave de identificação para mesclar informações correspondentes.

Quando Utilizar esta Ação

Utilize a ação Concatena duas listas quando houver a necessidade de:

  • Unificar resultados vindos de duas fontes diferentes (ex: uma lista de vendas do sistema A e uma lista de vendas do sistema B).

  • Juntar dados complementares de um mesmo registro que foram buscados em etapas separadas.

  • Consolidar relatórios parciais em um único objeto para processamento ou envio final.

Pré-requisitos

Diferente dos conectores de sistemas externos, o Agrupador de Listas é uma ferramenta nativa de tratamento de dados do LIGAí e não requer autenticação (usuário/senha). O único requisito é que você já possua, nas etapas anteriores do seu robô, as duas listas que deseja manipular.

Passo a Passo de Configuração

1. Adicionar a etapa no robô

  • Acesse o menu Meus Robôs.

  • Abra o robô desejado.

  • Selecione o conector Ligaí - Agrupador de Listas.

  • Escolha a ação Concatena duas listas.

2. Dados Gerais

Nesta seção, você deve informar quais listas serão unidas e qual critério deve ser usado.

  • Primeira Lista - A variável que contém o primeiro conjunto de dados (Array).
  • Segunda Lista - A variável que contém o segundo conjunto de dados a ser adicionado ou mesclado.
  • Chave de unificação - Nome do campo (propriedade) que existe em ambas as listas e servirá de referência para unir os itens. Se deixado em branco, o robô apenas adicionará os itens da segunda lista ao final da primeira. Se preenchido (ex: "email"), o robô tentará mesclar os dados dos itens que tiverem o mesmo e-mail.
    Exemplo: email ou cpf ou idVenda

3. Salvar a Configuração

Após configurar os campos:

  • Clique em Confirmar (botão azul na parte inferior da tarefa).

  • Em seguida, clique em Salvar no robô.

Erros Comuns e Como Proceder

  • Variável não é uma lista: Se você inserir uma variável que contém apenas um texto ou número (e não uma lista/array), a ação falhará. Certifique-se de que a origem dos dados é realmente uma lista.

  • Chave de Unificação Inexistente: Se você informar uma chave (ex: "cpf") que não existe nos itens de uma das listas, a unificação pode não ocorrer como esperado ou gerar duplicidade indesejada.

  • Tipos de Dados Diferentes: Tentar unificar listas com estruturas de objetos muito diferentes pode resultar em uma lista final desorganizada. Tente padronizar os dados antes de agrupar.