Declarar Lista Json

Permite criar uma lista Json

Visão Geral

O objeto Declarar Lista Json tem como objetivo criar e inicializar uma estrutura de lista (array) no formato JSON, permitindo que ela seja utilizada no fluxo da automação para armazenar múltiplos dados ou objetos JSON.

---

Funcionamento

O objeto realiza a alocação na memória do robô de uma lista JSON vazia, identificada por um nome específico definido na configuração. Através da opção "Adicionar Variável", é possível inserir valores ou outras variáveis já existentes para compor a lista no momento da sua declaração. Essa lista estruturada pode ser percorrida ou incrementada posteriormente durante a execução.

Quando usar

• Quando for necessário iniciar uma estrutura de lista JSON (Array) que receberá dados sequencialmente ao longo do fluxo do robô.

• Para agrupar múltiplos objetos ou valores em uma única lista padronizada, facilitando a manipulação e iteração em etapas futuras.

Quando não usar

• Quando o objetivo for criar e manipular apenas um objeto JSON simples e não uma lista/array (nestes casos, utilize o objeto "Criar Variável Json").

---

Configuração

---

Exemplos

Exemplo simples

Declarar uma lista JSON vazia nomeada como listaClientes logo no início da execução do robô. Posteriormente, o robô poderá utilizar objetos como "Inserir Dados na Lista Json" para adicionar informações extraídas de uma planilha dentro dessa lista criada.

Exemplo aplicado

Em um processo de extração de relatórios diários de vendas, o robô utiliza o objeto Declarar Lista Json para instanciar uma variável chamada listaVendasDiarias. Durante um laço de repetição, cada venda processada em formato de objeto JSON é adicionada a essa lista. Ao final do laço, a lista inteira é convertida em texto e enviada no corpo de uma requisição HTTP (API) para atualizar o sistema gerencial da empresa.

---

Retornos

---

Erros comuns e como evitar

• Deixar campos obrigatórios em branco: Os campos "Título" e "Nome da lista" possuem marcação de obrigatoriedade. Deixá-los vazios impedirá a compilação correta do objeto. Preencha sempre com nomes válidos.

---

Boas práticas

• Utilize um "Nome da lista" descritivo e coerente com a finalidade dos dados que serão armazenados (por exemplo, em vez de lista1, utilize listaFornecedores).

• Lembre-se de não utilizar espaços, acentuações ou caracteres especiais no "Nome da lista", prevenindo quebras e erros de formatação JSON durante a automação.