Converter para JSON

Visão Geral

O objeto Converter Lista para JSON transforma uma lista já carregada ou construída em uma representação JSON, que pode ser armazenada, enviada para APIs ou utilizada em processos que exigem esse formato. Ele está disponível na seção de Listas dos objetos do Studio.

---

Funcionamento

1. Arraste o objeto Converter Lista para JSON para o fluxo.

2. Preencha o campo Título com um nome descritivo.

3. Insira um Nome Identificador do Objeto (identificador interno usado em outros objetos).

4. Selecione a lista que será convertida.

5. (Opcional) Defina Condições de Leitura se quiser filtrar ou condicionar a conversão com base em outro objeto de filtro de lista.

---

Quando usar

• Quando precisar transformar uma lista em JSON para comunicação com APIs, logs ou exportação de dados.

• Para preparar dados de uma lista para uso em outros objetos que aceitam JSON.

• Facilitar o armazenamento e compartilhamento de dados de maneira estruturada.

Quando não usar

• Quando a lista já será consumida diretamente por objetos que aceitam o formato nativo de lista (sem necessidade de JSON).

• Se o processamento não exige transformação em JSON.

---

Configuração

CAMPO	DESCRITIVO
Título	Nome do objeto no Studio para fácil identificação na automação.
Nome Identificador do Objeto	Identificador interno único que poderá ser referenciado em outros objetos.
Selecionar objeto do tipo Lista	Lista que será convertida em JSON.
Condições de Leitura	(Opcional) Permite aplicar condições de leitura antes de converter a lista em JSON (ex.: uso de objeto de filtro).

---

Exemplos

Exemplo simples

1. Tenha uma lista de clientes populada.

2. Insira o objeto Converter Lista para JSON.

3. Nomeie o objeto (ex.: jsonListClientes).

4. Selecione a lista de clientes.

5. Ao executar o robô, a lista será convertida para JSON e poderá ser utilizada em outro objeto (como enviar em uma requisição HTTP).

Exemplo aplicado

Você extrai uma lista de produtos e seus preços de um sistema legado e deseja enviar essa informação a uma API REST da sua empresa:

1. Extraia os dados para uma lista.

2. Use Converter Lista para JSON para transformar essa lista.

3. Utilize o JSON gerado como corpo de uma requisição HTTP para integrar com a API de destino.

---

Retornos

O objeto retorna internamente a representação JSON da lista selecionada. Esse valor fica acessível através do Nome Identificador do Objeto configurado, podendo ser referenciado em objetos subsequentes.

---

Erros comuns e como evitar

• Lista não selecionada: Certifique-se de escolher uma lista válida no campo “Selecionar objeto do tipo Lista”.

• Nome identificador duplicado: Use um identificador único para evitar conflitos entre objetos.

---

Boas práticas

• Use nomes descritivos e padronizados para o campo Nome Identificador do Objeto.

• Valide o conteúdo da lista antes de converter para JSON para garantir que os dados estejam corretos.

• Quando filtrar dados, combine com um objeto de Criar Filtro na Lista para melhores resultados.