XML to JSON

1. Visão Geral

O componente XML to JSON (xml-to-json) converte um conteúdo XML em JSON, facilitando o processamento por outros componentes da plataforma (que trabalham naturalmente com JSON).

Use quando o fluxo recebe dados em XML (por exemplo, de uma API SOAP ou sistema legado) e precisa trabalhar com esses dados como JSON. Não use para XML muito complexo com namespaces avançados sem antes validar o resultado da conversão.

2. Pré-requisitos

Não há credenciais externas — processamento local.

3. Autenticação e Conexão

Não aplicável.

4. Configuração / Operações Suportadas

O componente tem uma única operação: converter um XML em JSON.

Campo	Obrigatório	Tipo	Descrição	Exemplo
xml	Sim	Texto (expressão)	O conteúdo XML a converter.	{$.body}
prettyPrint	Não	Texto ("true"/"false")	Se true, formata o JSON de saída com indentação. Valor padrão: "false".	"true"
includeRoot	Não	Texto ("true"/"false")	Se false e o XML tiver um único elemento raiz, remove esse elemento do JSON resultante, mantendo apenas o conteúdo interno. Valor padrão: "true".	"false"

5. Exemplos Práticos

Exemplo simples: converter uma resposta XML de um sistema legado em JSON.

Entrada:

{
  "respostaXml": "<cliente><nome>Maria Silva</nome><email>maria@exemplo.com</email></cliente>"
}

Configuração do componente:

{
  "componentName": "xml-to-json",
  "configurations": {
    "xml": "{$.body.respostaXml}"
  }
}

Resposta:

{
  "cliente": {
    "nome": "Maria Silva",
    "email": "maria@exemplo.com"
  }
}

Exemplo avançado: converter o mesmo XML, mas removendo o elemento raiz do resultado.

Configuração do componente:

{
  "componentName": "xml-to-json",
  "configurations": {
    "xml": "{$.body.respostaXml}",
    "includeRoot": "false"
  }
}

Resposta:

{
  "nome": "Maria Silva",
  "email": "maria@exemplo.com"
}

6. Erros Comuns e Troubleshooting

Erro / Sintoma	Causa provável	Como resolver
"XML content not found or is empty. Use 'xml' parameter with JSONPath expression."	O campo xml não foi preenchido ou não resolveu para nenhum valor.	Preencher xml com uma expressão que aponte para o conteúdo XML.
"XML content is empty"	O valor resolvido de xml está vazio.	Verificar se o conteúdo XML de origem realmente tem dados.
"Error converting XML to JSON: ..."	O XML de entrada não é válido/bem formado.	Revisar a estrutura do XML recebido.