# JSON to XML Transformer componente **JSON to XML Transformer** gera um XML baseado em um JSON recebido na sua mensagem de entrada. ## Parâmetros Dê uma olhada nas opções de configuração do componente. Parâmetros suportados por [expressões *Double Braces*](https://docs.digibee.com/documentation/connectors-and-triggers/pt-br/double-braces/overview) estão marcados com `(DB)`.

Parâmetro	Descrição	Valor padrão	Tipo de dado
JSON Field Path	JSON como caminho do campo string em notação com pontos (dotted notation).	payload	String
Root Element Name	Elemento raiz do XML gerado.	body	String
Root Element Attribute	Attribute for the root element of the generated XML.	N/A	String
Preserve Original	Se ativada, a opção preserva os campos originais.	True	Booleano
Header	XML header a ser incluído antes do XML payload.	<?xml version='1.0' encoding='UTF-8' standalone='no' ?>	String

## Fluxo de mensagens ### Entrada O componente espera uma mensagem em qualquer formato, mas vai procurar procurar por um caminho dentro da propriedade de configuração **JSON Field Path**. Alguns exemplos válidos de entrada: #### Exemplo 1 ``` { "orders": { "order": [ { "a": 1, "b": 1 }, { "a": 2, "b": 2 }, { "a": 3, "b": 3 } ] } } ``` #### Exemplo 2 ``` { "payload": { "test": { "a": 1, "b": 1 } } } ``` ### Saída A estrutura será igual a de entrada, porém com outra propriedade de JSON *string* e a sua representação de objeto JSON. Em caso de erro, a propriedade "error" será criada no mesmo nível da propriedade original. A notação com pontos (*dotted notation*) de JSON vai procurar pelo elemento raiz que está sendo processado pelo *pipeline* e realizar um cruzamento de acordo com as especificações passadas na propriedade **JSON Field Path**. #### Exemplo Em uma representação do **JSON Field Path** contendo a.b.c.d, "a" será procurado no elemento raiz. Em seguida será o "b", depois o "c" e finalmente o "d". Se um *array* for encontrado durante o cruzamento, então o algoritmo vai gerar um caminho de cruzamento para cada elemento no *array*. O algoritmo substitui todas as ocorrências do caminho definido em **JSON Field Path**. **Sem erro** ``` { "XPTO": "TEMPLATE TRANSFORMADO" "_body": {} } ``` * **\_body:** se a opção **Preserve Original** estiver habilitada, a propriedade será exibida na saída contendo o JSON de entrada. * **XPTO:** nome dinâmico baseado na configuração do **JSON Field Path** nas propriedades do componente. **Com erro** ``` { "body": null, "_error": "Can not construct instance of java.util.LinkedHashMap: no String-argument constructor/factory method to deserialize from String value ('')\n at [Source: N/A; line: -1, column: -1]", "_body": "" } ``` * **\_body:** se a opção **Preserve Original** estiver habilitada, a propriedade será exibida na saída contendo o JSON de entrada. * **\_error:** descrição do erro que ocorreu na execução. * **XPTO:** nome dinâmico baseado na configuração do **JSON Field Path** nas propriedades do componente. ## JSON to XML Transformer em ação ### Exemplo 1 * **JSON Field Path:** orders * **Root Element Name:** doc * **Preserve Original:** habilitado * **Header:** \ #### Entrada ``` { "orders": { "order": [ { "a": 1, "b": 1 }, { "a": 2, "b": 2 }, { "a": 3, "b": 3 } ] } } ``` #### Saída ``` { "orders": "112233", "_orders": { "order": [ { "a": 1, "b": 1 }, { "a": 2, "b": 2 }, { "a": 3, "b": 3 } ] } } ``` ### Exemplo 2 * **JSON Field Path:** payload * **Root Element Name:** xpto * **Preserve Original:** desabilitado #### Entrada ``` { "payload": { "test": { "a": 1, "b": 1 } } } ``` #### Saída ``` { "payload": "11" } ```