Inserir Dados na Lista Json
Permite inserir dados na lista Json
Visão Geral
O objeto Inserir Dados na Lista Json tem como objetivo adicionar (anexar) um novo elemento — seja um valor simples, uma variável ou até mesmo um objeto JSON inteiro — dentro de uma lista JSON (Array) que já foi previamente declarada no fluxo da automação.
Funcionamento
O objeto localiza uma lista JSON informada pelo usuário e insere o valor desejado no final dessa lista. Através do botão "Adicionar Dado", a interface permite criar múltiplos blocos de configuração, possibilitando ao usuário realizar mais de uma inserção simultaneamente (inclusive em diferentes listas, dependendo de como configurar cada bloco) em um único passo do robô.
Quando usar
Para popular uma lista JSON dinamicamente, como em laços de repetição (loops) em que, a cada iteração, um novo registro capturado precisa ser guardado.
Para adicionar dados estruturados ou variáveis extraídas de outros sistemas (como de planilhas ou de um formulário web) em um Array unificado.
Quando não usar
Para modificar ou atualizar um valor que já existe dentro do JSON (neste caso, utilize o objeto "Manipular Valores Json").
Para criar uma lista JSON do zero. A lista precisa ser instanciada previamente com o objeto "Declarar Lista Json" antes de poder receber dados por este objeto.
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: "Inserir Dados na Lista Json - Novos Clientes".
Adicionar Dado
Botão utilizado para adicionar novos blocos de configuração, permitindo a inserção de múltiplos dados em uma única execução deste objeto.
Estrutura de Bloco
A configuração de onde e o que inserir ocorre dentro de um bloco delimitado (marcado por uma linha tracejada). Para cada dado que você deseja inserir, você deve configurar um bloco contendo os campos abaixo:
CAMPO
DESCRITIVO
Lista Json
A variável do tipo Lista JSON (Array) previamente declarada onde o novo dado será inserido.
Tipo do valor
O formato do dado que será adicionado à lista (por exemplo: Texto, Número, Booleano, etc.).
Valor a ser inserido
O dado real, texto ou variável que será efetivamente incluído na lista configurada.
Exemplos
Exemplo simples
Após declarar uma lista vazia chamada listaDeStatus, utilizar este objeto configurando o campo "Lista Json" com listaDeStatus, o "Tipo do valor" como Texto e o "Valor a ser inserido" como Processamento Concluído. O texto será salvo dentro do Array.
Exemplo aplicado
Em uma automação de emissão de notas fiscais, o robô lê uma planilha do Excel linha por linha. A cada linha aprovada, o robô agrupa os dados de faturamento do cliente em uma variável JSON temporária e utiliza o objeto Inserir Dados na Lista Json para anexar esse bloco de dados dentro da lista global faturasProcessadas. No fim da execução, essa lista completa é enviada por e-mail à diretoria financeira.
Erros comuns e como evitar
Tentativa de inserir em lista inexistente: Apontar o campo "Lista Json" para uma variável que ainda não foi iniciada pelo objeto "Declarar Lista Json". Isso acarretará erro de execução pois a estrutura do Array ainda não existe na memória.
Deixar campos obrigatórios em branco: Os campos "Lista Json" e "Valor a ser inserido" possuem validação obrigatória no bloco. Deixá-los vazios impedirá a compilação e execução correta do seu robô.
Boas práticas
Sempre verifique se o Tipo do valor corresponde ao dado real que está sendo incluído no "Valor a ser inserido" (por exemplo, certifique-se de escolher "Número" se estiver inserindo variáveis matemáticas) para evitar problemas de compatibilidade nos arquivos JSON exportados ou em integrações com APIs posteriormente.
Last updated
Was this helpful?