Módulo XML

• Definição

• Configuração do módulo

  • Operação Converter XML para JSON

  • Operação Converter JSON para XML

    • Parâmetros

Definição

O módulo ferramental XML, módulo padrão da plataforma 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

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

Operação Converter XML para JSON

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.

Tela de configuração do conversor de XML para JSON

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 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

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.

Tela de configuração do conversor do JSON para XML

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:

[
   {
      "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" ou pelo uso de uma SMOP.

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.

Saiba sobre o Cabeçalho do Módulo aqui.