Converter XML para JSON

Objeto utilizado para converter um arquivo XML em JSON

Visão Geral

O objeto Converte XML para Json é utilizado para transformar um objeto XML carregado no robô em uma estrutura no formato JSON.

Essa conversão permite que os dados originalmente estruturados em XML possam ser manipulados como JSON, facilitando integrações com APIs, serviços web e manipulação de dados estruturados dentro do robô.

O objeto opera sobre um XML previamente importado, normalmente utilizando o objeto Importar XML, que carrega o arquivo XML para utilização nas operações do fluxo.

A versão atual do componente possui suporte a versões diferentes do conversor, mantendo compatibilidade com implementações antigas e oferecendo uma nova implementação mais adequada para novos robôs.

---

Funcionamento

O funcionamento do objeto ocorre da seguinte forma:

1. Um XML é previamente carregado no robô utilizando o objeto Importar XML.

2. O objeto Converte XML para Json recebe esse XML como entrada.

3. O conversor processa toda a estrutura hierárquica do XML.

4. A estrutura resultante é convertida para JSON equivalente, preservando os elementos e seus valores.

5. O resultado pode ser utilizado posteriormente em outros objetos do robô.

Quando usar

• Quando for necessário transformar dados XML em JSON.

• Em integrações com APIs que trabalham com JSON.

• Para facilitar a manipulação de dados estruturados no robô.

• Quando um processo recebe arquivos XML, mas o tratamento dos dados será feito em JSON.

---

Configuração

CAMPO	DESCRITIVO
Versão do componente	Define a versão do componente de conversão utilizada pelo objeto.
Título	Nome do objeto dentro do fluxo do robô. Pode ser alterado para facilitar a identificação no processo.
Nome Identificador do Objeto	Identificador único do objeto dentro do robô. Esse nome será utilizado para referenciar o resultado em outros objetos.
Selecionar objeto do tipo XML	Seleciona o objeto XML que será convertido para JSON. Esse XML normalmente é criado utilizando o objeto Importar XML.
Salvar XML no log de execução	Quando habilitado, registra o XML utilizado durante a execução no log do robô.

---

Estrutura de Bloco

Este objeto não possui estrutura de bloco adicional, pois a conversão ocorre diretamente sobre o XML selecionado.

Toda a estrutura do XML é automaticamente analisada e convertida para JSON.

---

Exemplos

Exemplo simples

Fluxo básico de conversão:

1. Utilizar o objeto Importar XML para carregar o arquivo.

2. Configurar o objeto Converte XML para Json selecionando o XML importado.

3. Utilizar o JSON gerado em objetos posteriores do robô.

Exemplo aplicado

Cenário: conversão de uma nota fiscal em XML para JSON para envio a uma API.

Fluxo do robô:

1. Importar o XML da nota fiscal.

2. Utilizar o objeto Converte XML para Json.

3. Utilizar o JSON gerado em uma chamada de API REST.

Exemplo de transformação:

XML:

<cliente>
  <nome>Maria</nome>
  <cidade>São Paulo</cidade>
</cliente>

JSON resultante:

{
  "cliente": {
    "nome": "Maria",
    "cidade": "São Paulo"
  }
}

---

Retornos

---

Erros comuns e como evitar

XML não selecionado

O objeto exige um XML previamente configurado.

Como evitar:

• Garantir que o XML foi importado utilizando Importar XML antes da conversão.

Estrutura XML inválida

Caso o XML esteja mal formatado, a conversão pode falhar.

Como evitar:

• Validar o XML antes de executar o processo.

---

Boas práticas

• Sempre validar o XML antes da conversão.

• Utilizar nomes claros no campo Nome Identificador do Objeto para facilitar o uso do JSON em outros objetos.

• Utilizar a opção de log apenas quando necessário para evitar aumento desnecessário do tamanho do log.