Converter Texto para Json

Converte um texto para o formato Json caso possível.

Visão Geral

O objeto Converter Texto para Json é utilizado para transformar um conteúdo textual em uma estrutura JSON, desde que o texto esteja em um formato válido para conversão.

Esse objeto é útil quando o robô recebe dados em formato de texto bruto, mas precisa manipulá-los como JSON estruturado para realizar leituras de propriedades, iterações ou integrações com APIs.

A conversão permite que dados originalmente textuais sejam utilizados em operações que exigem um formato estruturado.

---

Funcionamento

O objeto recebe como entrada um texto contendo uma estrutura JSON válida e realiza a conversão para o tipo Json dentro do robô.

Após a execução:

1. O robô recebe um texto contendo estrutura JSON.

2. O objeto Converter Texto para Json tenta interpretar esse conteúdo.

3. Caso o texto esteja em formato válido, ele é convertido para um objeto JSON.

4. O JSON convertido pode então ser utilizado em outros objetos do fluxo.

Caso o conteúdo não esteja em formato JSON válido, a conversão não será realizada.

Quando usar

• Quando um robô recebe parâmetros em formato de texto e precisa convertê-los para JSON.

• Quando o retorno de uma API chega como texto e precisa ser tratado como JSON.

• Quando dados são lidos de um arquivo texto contendo estrutura JSON.

Quando não usar

Não há restrições explícitas documentadas para uso desse objeto.

---

Configuração

CAMPO	DESCRITIVO
Título	Nome do objeto no fluxo do robô. Pode ser alterado apenas para facilitar a identificação dentro da automação.
Nome Identificador do Objeto	Identificador único do objeto dentro do robô. Pode ser renomeado para facilitar a reutilização em outros objetos, mas deve permanecer único e não pode conter espaços ou caracteres especiais.
Texto Json	Texto que será convertido para JSON, caso esteja em um formato válido.

---

Estrutura de Bloco

Não há estrutura de bloco específica documentada para este objeto.

---

Exemplos

Exemplo simples

Um robô possui um texto contendo um JSON:

{
  "nome": "João",
  "idade": 30
}

Esse texto é enviado para o objeto Converter Texto para Json, que transforma o conteúdo em um objeto JSON utilizável no fluxo.

Exemplo aplicado

Um robô consome uma API externa que retorna os dados no seguinte formato textual:

{"status":"sucesso","dados":{"id":10,"nome":"Cliente"}}

O objeto Converter Texto para Json converte esse texto em JSON, permitindo que os campos sejam acessados posteriormente dentro da automação.

---

Retornos

O resultado da execução é a conversão do texto informado para uma estrutura JSON, que pode ser utilizada posteriormente no fluxo do robô.

---

Erros comuns e como evitar

Texto não está em formato JSON válido

• O objeto não conseguirá realizar a conversão.

• Certifique-se de que o texto possui estrutura JSON correta.

JSON incompleto ou mal formatado

Exemplo inválido:

{ nome: "João" }

Exemplo válido:

{ "nome": "João" }

---

Boas práticas

• Garantir que o texto enviado esteja em formato JSON válido antes da conversão.

• Utilizar nomes claros no Título para facilitar a manutenção do robô.

• Manter o Nome Identificador do Objeto padronizado para facilitar a reutilização em outros objetos.