XML para JSON
O módulo XML para JSON converte um conteúdo entre os formatos XML e JSON, nos dois sentidos. É útil para integrar com sistemas que trabalham em um formato diferente do usado no restante do seu fluxo.
Este módulo é diferente do módulo XML (categoria Resposta), que monta uma resposta HTTP em formato XML. Aqui o objetivo é converter um conteúdo já existente entre os dois formatos.
📷 Inserir print: visão geral do módulo XML para JSON na área de trabalho do fluxo
🧭 Como acessar
No menu lateral, clique em Gerenciamento de aplicativos.
Em seguida, clique em Fluxos.
Abra ou crie um fluxo e acesse a área de trabalho do fluxo.
No painel de módulos, localize a categoria Integração (identificada pela cor azul).
Arraste o módulo XML para JSON para a área de trabalho do fluxo.
📷 Inserir print: painel de módulos com a categoria Integração expandida e o módulo XML para JSON visível
🔍 Conhecendo o módulo
Ao clicar duas vezes no módulo na área de trabalho do fluxo, um painel de configuração é aberto na lateral da tela.
📷 Inserir print: painel de configuração do módulo XML para JSON aberto
🧩 Método
Escolha a direção da conversão:
XML → JSON — converte um conteúdo XML em JSON.
JSON → XML — converte um conteúdo JSON em XML.
📷 Inserir print: campo Método com as duas direções disponíveis
📝 Conteúdo
Dependendo da direção escolhida, preencha o campo correspondente (XML ou JSON) com o conteúdo a ser convertido. Você pode usar variáveis do fluxo.
No modo JSON → XML, preencha sempre o campo com um JSON válido. Um JSON mal formatado pode impedir a publicação do fluxo.
📷 Inserir print: campo de conteúdo preenchido conforme a direção escolhida
🔀 Saídas do módulo
O módulo tem duas saídas:
Sucesso — a conversão foi concluída, com o resultado disponível para os próximos módulos do fluxo.
Erro — o conteúdo informado não pôde ser convertido (por exemplo, XML ou JSON mal formatado).
📷 Inserir print: módulo na área de trabalho do fluxo mostrando as saídas Sucesso e Erro
💡 Caso de uso
Cenário: um sistema externo retorna dados em XML, mas o restante do fluxo trabalha melhor com JSON.
Configuração:
Após receber a resposta em XML de um módulo de integração, adicione o módulo XML para JSON.
Selecione o método XML → JSON.
No campo XML, use a variável com o conteúdo recebido.
Conecte a saída Sucesso para usar o resultado já em JSON no restante do fluxo.
Resultado: o fluxo consegue trabalhar com os dados no formato mais conveniente, sem depender do formato original do sistema externo.
📌 Dicas úteis
Ao converter de XML para JSON, atributos das tags XML (como
<produto id="123">) não são incluídos no resultado — apenas o conteúdo e a estrutura das tags são convertidos.Valores numéricos e de verdadeiro/falso escritos como texto dentro do XML são convertidos automaticamente para número ou booleano no JSON resultante.
Sempre conecte a saída Erro a algum tratamento, já que conteúdos mal formatados podem falhar na conversão.
No modo JSON → XML, valide o JSON antes de publicar o fluxo, para evitar problemas de publicação.
📝 Resumo
O módulo XML para JSON converte conteúdo entre os formatos XML e JSON, nas duas direções.
O campo de conteúdo muda conforme a direção escolhida no campo Método.
Atributos XML são descartados na conversão para JSON; valores numéricos e booleanos são convertidos automaticamente.
O módulo tem uma saída de Sucesso e uma de Erro.