Limpar Lista Json

Realiza a limpeza de uma lista Json

Visão Geral

O objeto Limpar Lista Json tem como objetivo remover todos os itens presentes em uma lista JSON (Array) previamente declarada e populada, retornando-a ao seu estado inicial (vazia, representada por []).

---

Funcionamento

Ao ser executado, o objeto acessa a variável do tipo lista JSON especificada no campo de configuração e apaga integralmente o seu conteúdo. A variável continua instanciada na memória do robô para uso futuro, porém sem nenhum dado estruturado ou valor armazenado em seu interior.

Quando usar

• Quando for necessário reutilizar uma mesma lista JSON em um processo iterativo (como um laço de repetição) para processar novos blocos de informações, sem misturar os dados da iteração atual com os da iteração anterior.

• Para liberar espaço ou resetar os dados temporários de uma lista após a sua utilização ter sido concluída em determinada etapa do fluxo.

Quando não usar

• Quando o objetivo for excluir ou modificar apenas um item específico dentro da lista (neste caso, a lista inteira será apagada).

• Quando a intenção for destruir a variável da memória (este objeto apenas esvazia a lista, não deleta a declaração da variável em si).

---

Configuração

CAMPO	DESCRITIVO
Título	É o nome do objeto e não precisa ser alterado, a menos que você queira identificá-lo para facilitar a localização dele no robô, por exemplo: "Limpar Lista Json - Faturas Processadas".
Lista Json	É a variável do tipo lista JSON, previamente declarada no fluxo, que terá todos os seus dados apagados.

---

Exemplos

Exemplo simples

No final de um laço de repetição (Loop), configurar o objeto selecionando a variável lista1 no campo "Lista Json". Isso garantirá que, ao iniciar o próximo ciclo do laço, a lista1 não contenha resíduos da execução anterior.

Exemplo aplicado

Um robô acessa um sistema de chamados e, para cada chamado, coleta uma série de comentários e os armazena na variável listaComentarios. Após formatar e enviar esses comentários por e-mail para o gestor responsável, o robô utiliza o objeto Limpar Lista Json apontando para listaComentarios. Isso esvazia a estrutura e a prepara para receber os comentários do próximo chamado da fila, evitando que o e-mail do segundo gestor receba informações duplicadas do primeiro.

---

Erros comuns e como evitar

• Variável não declarada ou incompatível: Informar no campo "Lista Json" uma variável que não foi inicializada pelo objeto "Declarar Lista Json" ou que pertença a outro tipo de dado (como Texto ou Número). Isso causará falha na execução, pois o objeto espera uma estrutura de Array.

• Limpeza prematura: Executar este objeto antes de salvar ou enviar os dados da lista para o seu destino final. Como a ação limpa todos os dados, se não houver um backup, a informação será perdida.

---

Boas práticas

• Antes de utilizar o Limpar Lista Json, garanta que todas as validações e envios dos dados contidos nela (seja para um banco de dados, API ou arquivo) foram concluídos com sucesso.