Módulo Transformação de Dados
Definição
O módulo ferramental "Transformação de Dados", módulo padrão do Skyone Studio para a utilização em qualquer fluxo, foi criado para a transformação de dados por meio de JSONATA, facilitando assim a criação de operações complexas.
JSONata é uma linguagem leve, projetada para consultar e transformar estruturas de dados JSON.
O módulo "Transformação de Dados" é composto por uma única operação, que permite a manipulação de vários dados e a transformação destes dados no formato que desejamos. Este módulo inicializa sempre o parâmetro data, o que nos permite, como vimos em Manipulação de Objetos, além de obter um conjunto de dados, filtrar para que somente um subconjunto específico seja evocado.
A "Transformação de Dados" é ideal para manipulações mais complexas de dados, com uma resposta interna no fluxo. Para manipulações de dados de menor complexidade, recomendamos o uso de uma SMOP. Para manipulações mais complexas de dados, mas que necessitem de uma resposta para uma requisição HTTP, recomendamos o uso do módulo "Retorno".
Configuração do módulo "Transformação de Dados"
O módulo "Transformação de Dados" aparece na opção Ferramentas da edição de um fluxo. Após clicar para adicioná-lo, o modal de configuração será exibido.
Configuração das variáveis
Neste bloco, na aba "Dados de Origem", há os seguintes campos:
Chave: identificação da variável
Valor: digite ou arraste uma variável
Tipo: escolha o tipo de dados mais adequado. As opções são: texto, número, booleano, objeto e array.
Se preferir, pode preencher o JSON Origem.
Após o preenchimento das configurações, clique em "Avançar".
Resultado
Nesta tela, é possível executar e visualizar as informações da transformação de dados e manipule-as com JSONata.
Para finalizar a configuração do módulo, clique em "Salvar".
JSONata e funções extras
O módulo de Transformação de Dados utiliza funções extras do JSONata para manipulação avançada de strings, criptografia e tratamento de arquivos.
Abaixo estão as funções disponíveis para otimizar seus fluxos de integração:
md5(value): Gera um hash MD5 em formato hexadecimal. Útil para verificações rápidas de integridade.
sha256(value, digest?): Gera um hash SHA-256, sendo mais robusto que o MD5. O padrão de saída é hex.
generateHmac(value, secret): Cria um código de autenticação de mensagem baseado em hash para assinar dados com segurança.
removeValues(value, callback): Remove chaves de um objeto ou array de forma recursiva com base em uma condição.
removeKeys(value, targetKey): Limpa campos indesejados em estruturas aninhadas removendo todas as ocorrências de uma chave específica.
splitPDF(value): Processa um PDF em Base64 e o separa em um array, onde cada item é uma página individual.
Como utilizar as funções na prática
Para utilizar as funções no seu módulo Transformação de Dados:
Clique em Editar no módulo para acessar o editor.
Insira a expressão JSONata utilizando a função extra desejada, como
md5(campo_origem).Clique em Executar para validar a geração do hash ou a limpeza da estrutura.
Verifique o resultado no painel de saída antes de salvar a configuração.
Atualizado
Isto foi útil?