XML to JSON Transformer

Descubra mais sobre o conector XML to JSON Transformer e como usá-lo na Digibee Integration Platform

O XML to JSON Transformer transforma um XML string em um objeto JSON.

Parâmetros

Configure o conector usando os parâmetros abaixo. Campos que suportam expressões Double Braces estão marcados na coluna Suporta DB.

Parâmetro

Descrição

Tipo

Suporta DB

Padrão

Alias

Nome (alias) para a saída deste conector, permitindo que você faça referência a ele posteriormente no fluxo usando expressões Double Braces.

String

✅

xml-to-json-1

XML Field Path

Caminho do campo XML a ser transformado, usando notação com pontos. Se o campo for uma matriz, todos os elementos serão processados. Você pode especificar vários campos separando-os por vírgulas.

String

❌

body

Preserve Original

Se habilitado, os campos originais serão preservados no resultado da transformação. Para diferenciar os campos originais dos transformados, um sublinhado (_) é adicionado no início dos nomes dos campos originais.

Booleano

❌

True

With Namespace

Se habilitado, os namespaces XML são preservados no resultado da transformação.

Booleano

❌

True

Remove XML Attributes

Se habilitado, os atributos XML ficarão ocultos no resultado da transformação.

Booleano

❌

False

All Values As String

Se habilitado, todos os valores de tags XML serão convertidos para o tipo string.

Booleano

❌

False

Escape Special Characters

Se habilitado,escapa automaticamente caracteres XML reservados (&,<,>) para evitar erros de análise durante a transformação de dados.

Booleano

❌

False

Tolerate Invalid XML

Se habilitado, um objeto JSON de fallback será retornado em vez de lançar uma exceção para XML inválido.

Booleano

❌

False

Fluxo de mensagens

Entrada

O conector não requer uma mensagem de entrada específica. Você só precisa configurar o parâmetro XML Field Path com uma referência ao caminho do campo que contém o XML a ser transformado. Este campo deve estar presente na saída da etapa imediatamente anterior à execução do XML to JSON Transformer.

Saída

A estrutura de saída permanece a mesma que a recebida na etapa anterior. Os campos especificados no parâmetro XML Field Path são transformados em sua representação de objeto JSON. Se ocorrer um erro, uma propriedade error é criada no mesmo nível da propriedade original.

Quando o parâmetro Preserve Original estiver habilitado, cada campo definido no parâmetro XML Field Path gera uma propriedade adicional prefixada com um sublinhado (_), contendo a sequência XML original.

A notação com pontos de JSON identifica o elemento raiz que está sendo processado pelo pipeline e navega por ele de acordo com o caminho definido no parâmetro XML Field Path.

Exemplo:

Em um parâmetro XML Field Path representado como a.b.c.d, o conector irá:

Procurar o elemento a no nível da raiz.
Dentro de a ele vai encontrar b.
Então, dentro de b ele vai encontrar c.
Por fim, ele vai acessar d, que é o elemento a ser transformado.

O conector identifica cada <d> elemento dentro <c>→<b>→<a> e os converte em JSON.

Se um array é encontrado ao longo do caminho (por exemplo, se b contém vários itens), o algoritmo processa cada elemento do array individualmente, criando um caminho separado para cada um.

Em outras palavras, o algoritmo substitui todas as ocorrências do caminho definido no parâmetro XML Field Path ao longo da mensagem.