# Módulo XML

* [Definição](#definicao)
* [Configuração do módulo](#configuracao-do-modulo-xml) 
  * [Operação Converter XML para JSON](#operacao-converter-xml-para-json)
  * [Operação Converter JSON para XML](#operacao-converter-json-para-xml)
    * [Parâmetros](#parametros)

### **Definição** <a href="#definicao" id="definicao"></a>

O módulo ferramental **XML**, módulo padrão do **Skyone Studio** para a utilização em qualquer fluxo, foi criado para a conversão de dados do formato de arquivo **XML** para **JSON** e vice e versa.

O módulo **XML** é composto por duas operações: **Converter XML para JSON** e **Converter JSON para XML**.

### Configuração do módulo XML <a href="#configuracao-do-modulo-xml" id="configuracao-do-modulo-xml"></a>

O módulo **"XML"** aparece na opção **Ferramentas** da edição de um fluxo. Ao ser adicionado ao fluxo, ele oferece duas operações:

**Converter XML para JSON**: converte uma planilha em XML para o formato JSON

**Converter JSON para XML**: converte uma planilha em JSON para o formato XML

<figure><img src="/files/g2NM6B2F3s32YhafGdce" alt=""><figcaption></figcaption></figure>

#### Operação Converter XML para JSON <a href="#operacao-converter-xml-para-json" id="operacao-converter-xml-para-json"></a>

Esta operação permite que você converta uma tabela em XML com diferentes itens (produtos, clientes, etc) para o formato JSON, de forma que estas informações possam ser usadas posteriormente no fluxo.

Para utilizar esta opção, escolha "**Converter XML para JSON"** e, em seguida, clique em "**Salvar"**.

Para a configuração das variáveis, clique em "**Editar**" do componente recém-criado.

<figure><img src="/files/mmtih2QYp5p6qmxPlHNr" alt=""><figcaption><p>Tela de configuração do conversor de XML para JSON</p></figcaption></figure>

Sendo que:

* **XML**: informe o código em formato XML que precisa ser convertido
* **Símbolo de atributo**: informe o símbolo desejado para o código JSON; por padrão, é utilizado “$” (cifrão)
* **Símbolo de caractere**: informe o símbolo desejado para o código JSON; por padrão, é utilizado “\_” (underline)
* **XML CONVERTIDO PARA JSON**: aqui, depois que você clicar no botão **Validar**, será exibido o XML convertido no formato JSON

Exemplo de XML:

```xml
<?xml version="1.0" encoding="UTF-8"?>
<root>
   <element>
      <id>1</id>
      <name>Jaleco</name>
      <description>Jaleco de alta qualidade fabricado para atender aos clientes mais exigentes</description>
      <price>R$ 999,99</price>
      <available>true</available>
   </element>
   <element>
      <id>2</id>
      <name>Avental</name>
      <description>Jaleco de alta qualidade fabricado para atender aos clientes mais exigentes</description>
      <price>R$ 999,99</price>
      <available>true</available>
   </element>
   <element>
      <id>3</id>
      <name>Touca</name>
      <description>Jaleco de alta qualidade fabricado para atender aos clientes mais exigentes</description>
      <price>R$ 999,99</price>
      <available>true</available>
   </element>
   <element>
      <id>4</id>
      <name>Fronha</name>
      <description>Jaleco de alta qualidade fabricado para atender aos clientes mais exigentes</description>
      <price>R$ 999,99</price>
      <available>true</available>
   </element>
   <element>
      <id>5</id>
      <name>Embalagem</name>
      <description>Jaleco de alta qualidade fabricado para atender aos clientes mais exigentes</description>
      <price>R$ 999,99</price>
      <available>true</available>
   </element>
   <element>
      <id>6</id>
      <name>Porta talher</name>
      <description>Jaleco de alta qualidade fabricado para atender aos clientes mais exigentes</description>
      <price>R$ 999,99</price>
      <available>true</available>
   </element>
   <element>
      <id>7</id>
      <name>Porta absorvente</name>
      <description>Jaleco de alta qualidade fabricado para atender aos clientes mais exigentes</description>
      <price>R$ 999,99</price>
      <available>true</available>
   </element>
</root>
```

#### Operação Converter JSON para XML <a href="#operacao-converter-json-para-xml" id="operacao-converter-json-para-xml"></a>

Esta operação permite que você converta uma tabela em JSON com diferentes itens (produtos, clientes, etc) para o formato XML, de forma que estas informações possam ser usadas posteriormente no fluxo.

Para utilizar esta opção, escolha "**Converter JSON para XLM"** e, em seguida, clique em "**Salvar"**.

Para a configuração das variáveis, clique em "**Editar**" do componente recém-criado.

<figure><img src="/files/Q1qtkIwiG8yY6o0z3W5z" alt=""><figcaption><p>Tela de configuração do conversor do JSON para XML</p></figcaption></figure>

Sendo que:

* **Símbolo de atributo**: informe o símbolo desejado para o código JSON; por padrão, é utilizado “$” (cifrão)
* **Símbolo de caractere**: informe o símbolo desejado para o código JSON; por padrão, é utilizado “\_” (underline)
* **JSON**: informe o código em formato JSON que precisa ser convertido
* **JSON CONVERTIDO PARA XML**: aqui, depois que você clicar no botão "**Validar"**, será exibido o JSON convertido no formato XML

Exemplo de JSON:

```json
[
   {
      "id":1,
      "name":"Jaleco",
      "description":"Jaleco de alta qualidade fabricado para atender aos clientes mais exigentes",
      "price":"R$ 999,99",
      "available":true
   },
   {
      "id":2,
      "name":"Avental",
      "description":"Jaleco de alta qualidade fabricado para atender aos clientes mais exigentes",
      "price":"R$ 999,99",
      "available":true
   },
   {
      "id":3,
      "name":"Touca",
      "description":"Jaleco de alta qualidade fabricado para atender aos clientes mais exigentes",
      "price":"R$ 999,99",
      "available":true
   },
   {
      "id":4,
      "name":"Fronha",
      "description":"Jaleco de alta qualidade fabricado para atender aos clientes mais exigentes",
      "price":"R$ 999,99",
      "available":true
   },
   {
      "id":5,
      "name":"Embalagem",
      "description":"Jaleco de alta qualidade fabricado para atender aos clientes mais exigentes",
      "price":"R$ 999,99",
      "available":true
   },
   {
      "id":6,
      "name":"Porta talher",
      "description":"Jaleco de alta qualidade fabricado para atender aos clientes mais exigentes",
      "price":"R$ 999,99",
      "available":true
   },
   {
      "id":7,
      "name":"Porta absorvente",
      "description":"Jaleco de alta qualidade fabricado para atender aos clientes mais exigentes",
      "price":"R$ 999,99",
      "available":true
   }
]
```

Para finalizar a configuração do módulo, clique em "**Salvar**".

#### **Parâmetros**

Cada operação possui o seu parâmetro, que corresponde ao produto da conversão: **JSON** para a operação **Converter XML para JSON** e **XML** para a operação **Converter JSON para XML**. Quando utilizados, eles produzem o código resultante, o qual pode ser manipulado posteriormente pelo módulo [**"Transformação de Dados"**](/skyone-studio/integracoes/fluxos/modulos-ferramentais/modulo-transformacao-de-dados.md) ou pelo uso de uma [**SMOP**](/skyone-studio/integracoes/operacoes-de-dados/smop-pequenas-operacoes.md).

Ambos os parâmetros aparecerão no lado esquerdo do modal de configuração de cada operação do fluxo, desde que as operações estejam todas conectadas pelas linhas do fluxo.

{% hint style="info" %}
[Saiba sobre o Cabeçalho do Módulo aqui](/skyone-studio/integracoes/cabecalho-dos-modulos.md).&#x20;
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.skyone.cloud/skyone-studio/integracoes/fluxos/modulos-ferramentais/modulo-xml.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.